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Development 
Tools and 
Techniques 


e are living in an age of innovation. Businesses across every industry are making technology- 
enabled innovation a priority. The next big thing is always just around the corner—maybe it's even an idea that's 
percolating in your brain. 

In this issue, we explore some of the tools and techniques that can help you bring your 1 
ideas to fruition and make you more productive. Just look for our theme icon to find 
articles on this topic. 

In "Seven Open Source Tools for java Deployment." Bruno Souza and Edson Yanaga present a set of tools that 
you can use now to drastically improve the deployment process on projects big or small—enabling you and your 
team to focus on building better and more-innovative software in a less stressful environment. 

We explore the future of application development tools at Oracle in our interview with Oracle's Chris Tonas, 
who discusses plans for NetBeans IDE 9, Oracle's support for Eclipse, and key trends in the software develop¬ 
ment space. For more on NetBeans IDE, don't miss "Quick and Easy Conversion to Java SE 8 with NetBeans 
IDE 8" and "Build with NetBeans IDE, Deploy to Oracle Java Cloud Service." 

We also give you insight into Scrum, an iterative and incremental agile process, with 
a tour of a development team's Scrum sprint. Find out if Scrum will work for your team. 

Other article topics include mastering binaries in Maven-based projects, creating 
sophisticated applications with HTML5 and JSF, and learning to program with BlueJ. 

At the end of the day, tools don't make great code—you do. What tools are vital to 
your development process? How are you innovating today? Let us know. 


//send us your feedback / 

We'll review all 
suggestions for future 
improvements. 
Depending on volume, 
some messages might 
not get a direct reply. 


Caroline Kvitka, Editor in Chief 
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Find the Most 
Qualified Java 
Professionals 
for your 

Company's Future 

Introducing the 
Java Magazine Career 
Opportunities section - 
the ultimate technology 
recruitment resource. 

Place your advertisement 
and gain immediate access 
to our audience of top IT 
professionals worldwide 
including: corporate and 
independent developers, IT 
managers, architects and 
product managers. 


For more information 
or to place your 
recruitment ad or 
listing contact: 
tom.cometa@oracle.com 
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Selecting an API for Working with Microsoft Office Files 


Aspose APIs support several advanced features, and files not handled by 
open-source alternatives. Go to www.aspose.com to find out more. 


Microsoft Office documents are 
everywhere. Learning the ins and 
outs of Microsoft Office file formats 
is time-consuming so instead many 
developers use a third-party API. 
How do you select one? 

Open-Source 

Apache POI is a collection of 
open-source APIs that offers a 
specific set of features for reading 
and writing Microsoft Office file 
formats.The benefit of open-source 
APIs is that they are free and open 
to customization.That's great if you 


have a lot of time and resources. 
The drawback with open-source 
APIs is that they don't always have 
great support or documentation, 
and they support fewer features 
and variants.These drawback cost 
developers time, and reduce the 
dependability of their applications. 
Commercial APIs are a viable 
option, 

Aspose for Java 

Aspose for Java is a range of 
commercial Java APIs that help 
developers work with popular 


business file formats such as 
Microsoft Word documents, 
Microsoft Excel spreadsheets, 
Microsoft PowerPoint 
presentations, Adobe Acrobat PDF 
files, emails, images, barcodes and 
OCR. 

Each API is designed to perform a 
wide range of document creation, 
manipulation and conversion tasks 
quickly and easily, saving time and 
letting developers get on with 
programming. 

Feature-Rich 

Before selecting a solution, decide 
which features you need, Aspose's 
APIs are feature-rich. Aspose,Cells, 
for example, is an API for working 
with Microsoft Excel spreadsheets 
that can create and modify 
spreadsheets, work with external 
data, create and update formulas, 
create, manipulate and export 
charts, work with PivotTables, 
apply formatting and page settings. 
If a user can do it in Microsoft 
Excel, a developer can do it with 


Aspose.Celis. 

No open-source API has the same 
comprehensive feature support. 

Efficient and Robust 

All Aspose's APIs use a simple 
DOM and one API for working with 
a range of related formats, 
Aspose's Microsoft Office APIs, 
Aspose.Celis, Aspose. Words, 
Aspose.Slides, Aspose.Email, and 
Aspose .Tasks, are easy to work 
with, efficient, robust and 
independent of other libraries. 

Dependable Support 

Aspose for Java APIs are updated 
regularly and supported by free 
trials, code demos, extensive 
documentation, and support 
forums. 

Running a trial, reading forums and 
documentation gives you 
confidence that the solution you 
chose can do exactly what you 
need it to. 
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' OPEN SOURCE TOOLS FOR 

JAVA DEPLOYMENT 


Step up your game on projects of any size. BY BRUNO SOUZA AND EDSON YANAGA 


C ontinuous deployment is a set of 
automation practices that reduces 
lead time and improves the reliabil¬ 
ity, quality, and overhead of software 
releases. Implementing continuous 
deployment requires some work, but it 


has a very positive impact on a project 
By establishing a sound deployment 
pipeline and keeping all of your 
environments—from development to 
test to production—as similar as pos¬ 
sible, you can drastically reduce risks 


in the development process and make 
innovation, experimentation, and sus¬ 
tained productivity easier to achieve. 

Developers are usually aware of the 
basic building blocks for deployment: 
code repositories, such as Git and 


Development 
Tools and 
Techniques 


ART BY l-HUA CHEN 
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Subversion; and build tools, including 
Ant, Maven, and Gradle. But what other 
tools can help you step up? 

In this article, we present seven open 
source tools that you can use right now 
to improve the deployment process on 
projects big or small. These tools are 
among the best and most-used tools 
in their areas; they attract develop¬ 
ers who have created a large body of 
knowledge, plugins, and connectors 
that can be used in a wide range of 
situations and integrated with other 
tools and processes. 

But more importantly, these tools can 
dramatically improve your deployments. 
They can empower your team to build 
better and more-innovative software in 
a less stressful environment. 

1 JENKINS 

Start with Continuous Integration 

Released early in its life as the Hudson 
continuous integration (Cl) server, 
Jenkins is the most active and most 
used Cl server today. (For more on 
Hudson, check out "Mastering Binaries 
wit h Hu dson. Maven, Git, Artifactory, 

and Bi nt r ay," by Michael Huttermann, 
in this issue.) 

Jenkins is the cornerstone of auto¬ 
mation in your project, no matter what 
language your project is written in. But 
with its origins—and popularity—in the 
Java community, Jenkins is particularly 


Open Source Tools for Continuous Deployment 


DevOps practices accelerate the rate of releases (r) 
by increasing collaboration and reducing friction 
between developers and IT operations professionals. 
Open source tools help you to define good DevOps 
strategies and implement continuous deployment 
for projects of any size. 



ART BY l-HUA CHEN 
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Power and flexibility 
in Jenkins: The Build 
Pipeline Plugin makes 
it easy to chain Jenkins 
jobs to organize a 
deployment pipeline. 


well suited for Java projects from desk¬ 
top installers to remotely deployed web 
application archive (WAR) files to appli¬ 
cation servers in the cloud. 

Because of its extensive plugins com¬ 
munity, Jenkins can connect to diverse 
systems. With its flexible and power¬ 
ful job definition mechanism, you can 
use any kind of build tools to automate 
every part of the development process. 
This functionality creates a system that 
can grab information from multiple 
sources, run the build steps to create 
nearly any type of application you can 
think of, and connect to other target 
systems to deploy the application to 
whatever infrastructure is needed. 

To build a good deployment process, 
you need to grab a few of those plugins. 


Here are some that can't be left out of 
any deployment environment: 

■ Build Pipeline Plugin. The Jenkins 
delivery approach involves the chain¬ 
ing of related jobs through build 
triggers. This flexible functionality 
lets you create sophisticated pipe¬ 
lines, but it can be difficult to see the 
pipeline's "whole picture," the rela¬ 
tionships between jobs, and where 
in the pipeline the build is at a given 
moment. The Build Pipeline Plugin 
solves that problem by providing a 
nice overview of the build pipeline, 
so you can easily follow the build as 
it happens and even decide when 
things should be automatic or 
require a manual trigger. 

■ Parameterized Trigger Plugin. In a 



build pipeline, developers use the 
artifact that is generated as output 
from one job as the input for the next 
job in the pipeline. The Parameterized 
Trigger Plugin informs the next job 
which build result it must use to keep 
the pipeline moving. 

■ Copy Artifact Plugin. A complement 
of the Parameterized Trigger Plugin, 
the Copy Artifact Plugin uses the 
parameters received from the previ¬ 
ous job to fetch that job's resulting 
artifacts and uses them as the start¬ 
ing point of the next job. 

CHEF 

Turn Your Infrastructure 
into Source Code 

Chef is a provisioning automation 
framework that simplifies the configura¬ 
tion of your development or production 
environment—whether on-premises or 
cloud-based. It is a Ruby-based tool that 
does wonders to deploy any infrastruc¬ 
ture needed foryour Java application. 

By using Chef, you can define a proj¬ 
ect's infrastructure with Ruby scripts 
that are versioned within the project's 
source code repository. Chef scripts 
are called recipes , and they are bundled 
in cookbooks. With scripts written in 
Ruby, you have a well-known, generic 
scripting language to automate infra¬ 
structure activities. 

Any time you need to evolve the 
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LOSE THE STRESS 

These tools can 

dramatically 

improve your 

deployments. 

They can empower 
your team to build 
better and more- 
innovative software 
in a less stressful 
environment. 


LISTING 2 / LISTING 3 


S knife solo prepare host_username@host 


P Download all listings in this issue as text 


infrastructure, you can evolve the 
scripts and rebuild the full environ¬ 
ment with the new definitions. By 
doing so, Chef replaces lots of docu¬ 
mented (and undocumented) manual 
installations, configurations, and ad 
hoc decisions, and it creates clean, ver¬ 
sioned, automated steps to generate 
the infrastructure. This powerful con¬ 
cept allows the infrastructure defini¬ 
tion to evolve with the application and 
promotes team interaction. Having a 
common tool, a common repository, 
and a clear deployment process goes 
a long way to integrate the develop¬ 
ment and operations teams. 

Chef handles all kinds of infrastruc¬ 
ture components: from your operating 
system and the software that needs to 
be installed to any configuration you 
need to apply, such as users and IP 
addresses. But Chef can go much fur¬ 
ther if needed, handling firewalls, net¬ 
work devices, multiple servers, cloud 
environments, and other components 
that form your infrastructure. Besides 
building your application environment, 
Chef includes a client/server archi¬ 
tecture that lets you centrally manage 
patches and software upgrades on mul¬ 
tiple servers. 

The easiest way to start using Chef is 
with its chef-solo client version, which 
simplifies environment provisioning so 
you can build the necessary infrastruc¬ 
ture for your project with a single com¬ 
mand. After you have your cookbooks, 
you can use knife, Chefs command-line 


interface (CLI), to prepare a server by 
installing chef-solo in it, as shown in 
Listing 1 And you can automatically 
provision the server from the cook¬ 
books, as shown in Listing 2. 

3 VAGRANT 

Reproduce Development Environments 

Of all the tools mentioned in this 
article, Vagrant is probably the least 
concerned with deployment per se. 
Vagrant is focused on the developer, 
but it bridges development and pro¬ 
duction, helping to reduce inher¬ 
ent risk by minimizing discrepancies 
between the different environments 
of the deployment process. 

A common problem developers have 
is constructing a local development 
environment in which to run the appli¬ 
cation they're building. Target systems 
are becoming more sophisticated 
and complex, with multiple web and 
application servers, databases, library 
dependencies, queues, service inte¬ 
gration frameworks, caches, and load 
balancers, among other elements. This 
situation complicates the possibility of 


having development and test environ¬ 
ments that closely resemble the final 
production environment, making it 
difficult to create a reliable build-test- 
deploy pipeline. 

Vagrant generates virtual develop¬ 
ment environments from a text file 
definition called the Vagrantfile. You can 
have this definition checked in with the 
source code of your project, and every 
developer can then use Vagrant by run¬ 
ning a single command to provision 
a fully functional development envi¬ 
ronment identical to everyone else's. 
Locally, this environment is created as a 
virtual machine running within Oracle 
VM VirtualBox, Oracle's open source 
virtualization product. 

After you have a Vagrantfile config¬ 
ured, you run a single command: 

S vagrant up 

Here's how Vagrant meets deploy¬ 
ment: your Cl server can use the 
Vagrantfile to build virtual machines 
for your test and quality assurance (QA) 
environments. Then later—especially if 
Vagrant is integrated with Chef, Packer, 
or Docker—the Vagrantfile forms the 
basis for your continuous deployment 
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process to build your final production 
environment. 

At first look, Vagrant might seem 
similar to Chef, but in fact, they work 
great together. Chef helps you provi¬ 
sion your infrastructure and build your 
systems from development to pro¬ 
duction. Vagrant, however, helps you 
create provisioned virtual machines; 
it can use Chef to do the actual pro¬ 
visioning. Even better, Vagrant works 
amazingly well with Chef's chef-solo 
client to build development and test 
environments. This functionality 
allows Chef to define your infrastruc¬ 
ture, and you can run Vagrant to have 
a development environment that's 
similar to the target production sys¬ 
tem. All environments—development, 
test, QA, and production—can evolve 
together from the same Chef descrip¬ 
tion, which is versioned, tagged, and 
kept in your code repository. 

4 PACKER 

Generate Images for 
Multiple Environments 

In a "normal deployment," you pro¬ 
vision , or prepare, your systems for 
operation. Starting from a base system, 
you install all the needed software until 
you have a fully functional environment. 
Tools such as Chef help you automate 
the provisioning process, making it 


repeatable and easy to evolve. 

However, virtualization and cloud 
computing changed normal deploy¬ 
ment. Today, your "base system," 
which is usually encapsulated into a 
virtual image, can be prepared with 
everything you need, all the way to 
the application level and even the 
data. What we used to call provision¬ 
ing could take some time, but now it's 


simply starting a virtual machine and 
can be accomplished in seconds with 
everything ready to go. 

Building new virtual images is a 
painful process. Because of that, many 
teams keep large portions of their solu¬ 
tion outside the image. Then, after the 
virtual image is instantiated, they run 
extra processes to update the appli¬ 
cation from the repository, download 


It’s all in the image: 
Packer bundles the 
environment and the 
application, producing 
a ready-to-run virtual 
image appliance. 


«* n o 




jack.'-javaone VAgrant@mndeclc:~ packer-pro viston 102x31 

v.tg u nd fc:— 




$packer build javaone.json 
amazon-ebs output will be in this color. 

=> amazon-ebs: Creating temporary keypair: packer 534996df-6602-7fa9-ce04-28749d054a3B 
==> amazon-ebs: Creating temporary security group for this instance,,. 

=> amazon-ebs: Authorizing SSH access on the temporary security group... 

==> amazon-ebs; Launching a source AWS instance... 

amazon-ebs: Instance ID: i-f68fbda6 
==> amazon-ebs; Waiting for instance (i-f68fbda6) to become ready... 

--> amazon-ebs: Waiting for S5H to become available... 

==> amazon-ebs: Connected to SSH! 

==> amazon-ebs: Provisioning with chef-solo 
amazon-ebs: Installing Chef.,. 

amazon-ebs: % Total % Received % Xferd Average Speed Time Time Time Current 
Dload Upload Total Spent Left Speed 

100 14401 100 14401 0 0 56452 0 — t - : - 76195 

Downloading Chef for ubuntu... 

downloading https://www.opscode.com/chef/metadata?v=Giprerelease=false&p=ubuntu&pv=12.0 


amazon-ebs: 
amazon-ebs: 
amazon-ebs: 
amazon-ebs: 

4&m=x86_64 

amazon-ebs: 
amazon-ebs: 
amazon-ebs: 


to file /tmp/install.sh.892/metadata.txt 
trying wget... 

url https://opscode-omnibus-packages.sB.arnazonaws.com/ubuntu/12.04/x86_64/chef„ll. 


12.2-l_amd64.deb 

amazon-ebs: md5 cedd8a2df60a706e51f58adf8441971b 

amazon-ebs: sha256 af53e7ef602be6228dcbf68298e2513d3f37eb061975992abc6cd2d318e4a0c0 
amazon-ebs: downloaded metadata file looks valid.,, 

amazon-ebs: downloading https://opscode-omnibus-packages.s3.amazonaws.com/ubuntu/12.04/x86_64/chef 
„11.12.2-l„amd64,deb 

amazon-ebs: to file /tmp/install.sh.892/chef_ll.12.2-l_amd64.deb 
amazon-ebs; trying wget.,. 

amazon-ebs: Comparing checksum with sha256sum... 
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BIG IMPACT 

Implementing 
continuous 
deployment requires 
some work, but it 

has a very positive 
impact on a project. 


data, and adjust configurations. That 
way, the base image stays reasonably 
stable over the course of many deploy¬ 
ments. This process is good, but it 
complicates the evolution of the 
environment. It can create weird fail¬ 
ures when the application is deployed 
in an image that doesn't have the 
latest infrastructure improvements 
to support it. 

This is where Packer comes in. 

Packer is a powerful command-line 
utility that automatically generates 
images for different providers (Oracle 
VM Virtual Box, VMware, AWS, 
DigitalOcean, Docker, and so on). It 
can run at the end of your Cl process, 
and it reuses your Chef provisioning. 
The result of Packer's execution— 
which can take some time, depending 
on your provisioning needs—is a fully 
functional, everything-integrated, con¬ 
figured, and running virtual machine 
image that's ready to start. 

Because Packer generates the image 
automatically, you can run it at every 
release build and include in the image 
the latest version of your application, 
already deployed in the configured 
application server, with the data that 
needs to be there. You just need to 
start an instance and your system is 
up and running in a few seconds. It's 
ready to increase the pool in your load 
balancer, replace a failing server, or 
take over the job from the server that 
was running the previous version. 


All you need is a Packer template with 
your image definition, and then you run 
the following command: 

S packer build template.json 

@D0CKER 

Try Self-Sufficient and Portable 
Lightweight Containers 

Creating ready-to-boot virtual machine 
images is a sophisticated way to use 
cloud computing so you can scale your 
application. But dealing with full stacks, 
complete operating systems, applica¬ 
tion servers, and the rest might be over¬ 
kill. In many cases, all you want is to 
add one more application to your stack. 

Platform-as-a-service (PaaS) solutions 
have been well received by developers, 
because they can add their application 
to a predefined stack with little over¬ 
head to worry about. Simply push the 
code, and it runs. But this approach 
might be too simple. It requires that you 
run your application in a shared envi¬ 
ronment inside a cloud provider, with 
whatever stack is provided, and some¬ 
times with less flexibility than you'd like. 

This is where Docker comes in. Built 
on top of Linux Containers (LXC), 

Docker creates portable, self-sufficient 
containers that include your applica¬ 
tion. Docker can be run locally on your 
computer or scaled to cloud deploy¬ 


ments. By encapsulating everything 
your application needs in the container 
abstraction, Docker makes deployment 
easy. At the same time, because Docker 
deals with containers, your application 
doesn't need to carry all the baggage 
of a full operating system installation. 
Docker containers can be extremely 
lightweight, so you can run many con¬ 
tainers—even on small systems. 

You can configure a Docker image to 
include everything you need, as a PaaS 
provider would. And then, each con¬ 
tainer can host your application, with 
only what needs to be changed from 
application to application. Containers 
are easy to start, stop, manage, and 
evolve. They are also isolated, and 
applications can have their own version 
of libraries. 

Docker can be used both to create 
a PaaS-like environment and to make 
your Cl process easier by using con¬ 
tainers to manage test and QA envi¬ 
ronments with the same container 
definition that's put into production 
later. Docker also integrates well with 
Chef and Packer, and you can use those 
tools to generate a container from your 
application automatically. This same 
container can be used locally for builds 
and tests; it can be run by your Cl 
server for integration and deployment; 
and it can scale to virtual machines, 
local servers, and private or public 
clouds to run your production. 

After you have a Dockerfile config- 
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ured, you can easily start new contain¬ 
ers by running the following command: 

S docker run image/name command 

For example, Quinten Krijger has 
an Apache Tomcat image that you can 
download by running the following 
command: 

S docker pull quintenk/tomcat7 

And then you can use the follow¬ 
ing command to run the image as a 
daemon: 

S docker run -d quintenk/tomcat7 

**0 FLY WAY 

Database Migrations that 
Follow Your Applications 

We can't talk about deployment with¬ 
out mentioning databases. Developers 
understand howto upgrade an appli¬ 
cation, maintain compatibility with 
older versions of APIs, and deprecate 
functionality. But what about the data¬ 
base? The hardest part of an auto¬ 
mated deployment can be underdocu¬ 
mented SQL scripts that need to be run 
"just before" production, differences 
between the code and the schema, and 
evolution and rollback situations. 

Fly way shines in these situations. 
Developed in Java and focused on the 
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import com.googlecode.flyway.co re .api.mig rat ion.j dbc. JdbeM ig ration; 

import java„math.BigDetimal; 
import java.sql.Connection; 
import java.sql.ResultSet; 
import java.sql.Statement; 

public class implements JdbcMigration { 

private static final String UPDATE_10_PERCENT = 

"UPDATE CUSTOMER SET CREDIT_SCORE * CREDIT_SCORE * 1.1 WHERE ID - 

private static final String UPDATE_ANOTHER_1_PERCENT = 

"UPDATE CUSTOMER SET CREDIT_SCORE = CREDIT_SCQRE * 1.01 WHERE ID = %d‘; 


(^Override 

public void migrate(Connection connection) throws Exception { 
try (Statement statement = connection.createStatement()) { 

try (ResultSet resultSet = statement.executeOuery( "SELECT ID, CREDIT_SCORE FROM CUSTOMER")} { 
while (resuItSet.next()) { 

long id = resultSet.getLong( "ID") ; 

BigDecimal credit_score = resuItSet.getBigDecimal( "CREDIT^SCORE" ); 
if (credit_score.compareTo(new BigDecimal ("1009.00") ) > 0) { 
statement.executeUpdate( 

St ring. format ( UPDATE 10_PERCENT r id)); 

} 

else if (credit_score.comparelotnew BigDecimaK "10000.00" )) > 0) { 
statement.executeUpdate( 

St ring. format ( UPDATE_ANOTHER_l_PERCEtiT, id}); 


needs of Java developers, Flyway is a 
database migration framework that 
can migrate from any version of your 
database schema to the latest version. 
Flyway keeps the database definition of 
your application safe inside your version 
control system and turns your database 
into a clear, precise, and versioned set 
of instructions that can be re-created or 
migrated every time that is needed. 

Flyway has a CLI utility and also inte¬ 
grates with build tools such as Maven 
and Ant. It can run as part of your Cl 
process to upgrade or create a database 
before running tests or going into QA. 
Flyway can run SQL scripts or—if you 


have sophisticated database needs— 
specific Java code to handle migrations 
through the JDBC API. Through its API, 
you can also manage migrations from 
inside your application to implement 
database management functionality. 

If you are distributing an application, 
Flyway can handle the database cre¬ 
ation or migration on the first run. 

By turning your database schemas 
into code in your repository, Flyway 
provides visibility into the database 
and helps the whole team participate 
in its evolution. This integration pushes 
everyone to work together toward con¬ 
tinuous deployment. 


Powerful database 
migrations: Flyway can 
leverage the use of the 
JDBC API to handle 
schema migrations. 
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With Flyway configured, you can cre¬ 
ate or migrate your databases using this 
CLI command: 

S flyway migrate 

7 RUNDECK 

Support the Ops in DevOps 

That brings us to DevOps, a term that 
means communication, collaboration, 
and integration between developers 
and IT operations professionals. As 
developers, we know how good tools 
promote collaboration. When we save 
infrastructure definitions in our reposi¬ 
tories or we automate infrastructure 
creation in a way that benefits both 
developers and IT operations profes¬ 
sionals, we promote DevOps strategies 
in our projects. Each of these seven 
tools helps the collaboration between 
development and operations. 

Collaboration is important so we can 
deliver the software products and ser¬ 
vices that customers expect. But each 
group has a different view of what soft¬ 
ware and services are. While developers 
think about code, bugs, libraries, and 
dependencies, IT operations profession¬ 
als consider servers, nodes, security, and 
auditing. Developers worry about func¬ 
tionality; operations professionals worry 
about availability. Developers think that 
automation means building the source 
code and generating artifacts for deploy¬ 


ment. Operations professionals might 
call automation the discovery of new 
nodes and the dispatching of commands 
to multiple servers. These different views 
focus on the same servers and the same 
services, and they're both responsible for 
getting working software to the end user. 

Rundeck. a Java-based web applica¬ 
tion, helps the integration and col¬ 
laboration of these two worldviews by 
functioning as the operations console 
foryour environment. Rundeck knows 


about the details of the environment, 
such as the nodes you have and the 
services you're running. It can execute 
actions in the environment, by either 
running predefined jobs or executing ad 
hoc commands on one or more nodes. 

Rundeck integrates beautifully with 
the other tools in this set, and it retrieves 
detailed environment information from 
Chef servers or collects node information 
directly from your cloud provider—so 
you have an updated view, even in a 


Managing multiple 
nodes: Rundeck 
runs commands 
in several nodes, 
and aggregates 
the results. 
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Go: One More Tool 

ThoughtWorks has just released Go, a continuous integration and 
release management server, as an open source, Apache-licensed 
project . Go is a Java-based server and has a role similar to Jenkins, 
but the two have slightly different concepts. Constructed around 
the full build pipeline rather than around independent jobs, Go 
focuses on the code-build-test-deploy process. This structure 
makes continuous deployment a main focus in your project and helps 
the team think about it from the start. It’s still too early to say whether 
developers will accept Go and what place it will claim in this market. 
However, it’s a great concept and a fully functional tool that can be 
easily integrated with the seven other tools. 

^ Build PipeNn* [jenk>nV| £> Pipeline AnlviLy - Co 3 - arvils 

4* 0 2 localhqst inSB/gDy Gab/pipeline/history/qtDnsp 



Ready-to-run deployment: Go’s built-in pipeline clearly shows 
successful, failed, and manually triggered builds. 
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dynamic cloud environment. Rundeck 
then executes actions on a single node 
or on hundreds of nodes. It does that 
either directly through Secure Shell 
(SSH) or by integrating with Chef or other 
tools, and by defining filters to decide 
what to run and where. The results and 
outputs are then aggregated, helping 
make sense of what is happening. 

A secure web dashboard provides 
access control to Rundeck jobs. Jobs 
are also turned into API calls that can 
be called from scripts through a CLI or 
directly from Jenkins jobs through a plug¬ 
in that further simplifies the integration. 
This allows operations professionals to 
define actions that developers can run, 
creating self-service, on-demand IT 
services. Thus, IT procedures essentially 
are automated, encapsulated, and made 
easily available for the build process to 
call into. Operations professionals are 
part of the process and define what can 
be done. But they don't become a bot¬ 
tleneck, because the services they define 
can be run by developers when needed. 

The Rundeck CLI is a powerful man¬ 
agement tool. If you want to copy and 
run a script to all your UNIX machines, 
you can simply run the command 
shown in Listing 3. 

CONCLUSION 

The tools described in this article are 
all open source tools, and you can 
implement them today in your project. 


They can be used to deploy all kinds of 
applications, and are particularly well 
suited to deploying Java applications 
and services. 

Try these tools and experience how 
they help you to move toward a full 
deployment pipeline for your Java 
projects. </article> 

MORE ON TOPIC: 


Development 
Tools and 
Techniques 


Bruno Souza is a Java developer and open 
source evangelist at Summa Technologies 
and a cloud expert at ToolsCloud. He is the 
founder and coordinator of SouJava—one 
of the world’s largest Java user groups— 
founder of the Worldwide Java User 
Groups Community, and director of the 
Open Source Initiative (OSI). 

Edson Yanaga is a technical lead at 
Produtec Informatica and a principal 
consultant at Insula Tecnologia. An open 
source user, advocate, and developer, his 
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lifecycle management, cloud computing, 
DevOps, and software craftsmanship. 

He is a frequent speaker at international 
conferences. 

/learn more 

• Source code demo 

• Bruno Souza's blog 

• Edson Yanaga's blog 
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JaVa 8 ships today 
JDT support for Keple, 
SR2 available today 
Go see the Java 8 Day 
talks! 


Clockwise fromjtop: Mike Milinkovich 
ponders the future; Thomas Schindl 
gives a JavaFX 8 update; Stuart 
Marks (left) and Georges Saab kick 


THE FUTURE 


EclipseCon 2014, held March 
17-20 in San Francisco, 

California, boasted 14tutorials, 120 
sessions, and four theme days—including 
Java 8 Day on the second day of the con¬ 
ference. Java 8 launched a few hours into 
the day, which added an air of excitement 
and talk of taking down the hotel's Wi-Fi 
with all of the downloads. The fact that all 
of the major IDEs provided Java 8 support 
that day was a sign that sometimes the 
planets just align. 

Day two of the conference kicked off 
with the keynote "Eclipse: The Next Ten 
Years" by Mike Milinkovich, executive 
director of the Eclipse Foundation. After 
discussing the history and success of 
Eclipse, Milinkovich provided the caveat 
that he does not have the power to dic¬ 
tate what projects will occur in the Eclipse 
community. "I think of my title as chief 
Eclipse cheerleader," he said. "It's a very 
Darwinian, bottom-up process. What sur¬ 
vives is what works," he explained. 

Milinkovich talked about three trends 
that will have an impact on developers 
and IDEs, and they apply tojava and the 
open source community as well. 

Trend Software Is Eating the World. 

With a nod to Marc Andreessen, 
Milinkovich said that software is becom¬ 
ing ever more important and has an effect 
on everything, including how companies 
are valued. He gave the example of the 
Airbus aircraft: the amount of software 
code used onboard on this class of aircraft 
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Thomas Schindl explains what’s new in 
JavaFX 8. 



Denis Roy, IT director at the Eclipse 
Foundation, discusses the conference. 



Tristan Faure of Atos talks about why he 
attends EclipseCon. 


PHOTOGRAPHS AND VIDEOS BY BOB ADLER/GETTY IMAGES 


grew four times largerin three years. So should 
Airbus think of itself as an airplane company or 
a software company? Notonlyisthecodebase 
huge, but the lifespan of applications can span 
generations. "Would you program differently if 
your granddaughter will have to maintain your 
code?" Milinkovich asked with a smile. 

Trend A The Internet of Things. Whether the 
Internet of Things (IoT) is a US$14 trillion mar¬ 
ket or whether that's hype, IoT is big and will 
continue to grow, he said, and most impor¬ 
tantly, we need open IoT. Milinkovich said that 
Eclipse has 14 projects in the IoT space, with 
more on the way. There was a lot of interest in 
IoT throughout the conference. 

Trend b The Cloud. Evans Data predicts that 
by 2019, 65 percent of developers will primar¬ 
ily develop for cloud, he said. Does that mean 
all the functionality from current desktop IDEs 
should be moved to the cloud? Milinkovich 
introduced a demo of Project Flux, which 
showed howto connect an Eclipse project to the 
cloud. EclipseCon offered multiple sessions on 
developing in the cloud. 



JAVA 8 DAY 


Java 8 Day at EclipseCon kicked off with the 
standing-room-only session "New Features in 
java SE 8," with Oracle's Georges Saab, java 8 
supports the basic definition of java, he said. 

It is simple, stable, fast, scalable, and easy to 
read. Saab also gave his "top 8" reasons to use 
JDK 8: lambda expressions and the Stream API, 
the new Date and Time API, Compact Profiles, 
Nashorn, java Flight Recorder and Java Mission 
Control, the end of permanent generation, 
updated standards, and the fact that it was 
developed in OpenJDK. Saab encouraged every¬ 
one to move to java 8 as soon as possible, join a 
Java user group (JUG), and check out OpenJDK 
and Adopt OpenJDK. 


Java 8 Day continued 
with another full ses¬ 
sion on lambda expres¬ 
sions with Alex Buckley, 
Specification Lead for 
the Java language and 
Java Virtual Machine 
(JVM). He described 
lambda expressions as 
"perhaps the biggest 
upgrade ever to the Java 
programming model" 
but noted that Java 8 is 
much more than lamb¬ 
das. He mentioned 
the new Stream API 


and said, "The jump 
from collections to 
streams is largerthan 
the jump from anony¬ 
mous classes to lambda 
expressions." 

Other sessions at 
Java 8 Day included 
Thomas Schindl on 
what's new in JavaFX 8, 
and Oracle's Hinkmond 
Wong on Java SE 8 
Compact Profiles for 
embedded develop¬ 
ment. It was a great day 
forjava 8. 
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FEATURED JAVA USER GROUP 


The VirtuaLJava User 
Group (vJUG) was founded 
in October 2013 by Simon 
Maple. vJUG is an online usergroup 
aimed at java developers who don't live 
near an activeJUG, orwho want more 
technical content. Maple notes, "Our 
goals are simple: to provide great techni¬ 
cal content from the best speakers to a 
global community of developers, regard¬ 
less of location, time zone, or country." 

Although vJUG has only been meet¬ 
ing since November 2013, it already has 
more than 1,000 members from more 
than 50 different countries. To date, 
vJUG has been meeting two or three 
times each month. "We hold our meet¬ 
ings online using Google Hangouts On 
Air, YouTube, and good old IRC [Internet 
Relay Chat]," says Maple. "Google 
Hangouts On Air allow 10 speaking par¬ 
ticipants only, but we connect it with our 
vJUG YouTube channel to allow unlim¬ 
ited viewers, live. This provides access to 
our content without the need for people 
to download or install anything on client 
machines. We also use IRC as the mech¬ 
anism for participants to talk about 
what's being presented live, as well as 
ask questions to others in the chat." 


vJUG organizers are also looking into 
the possibility of doing online confer¬ 
ences and hack sessions. Maple also 
hopes to get vJUG involved in the 
Adopt-a-JSR and Adopt OpenJDK pro¬ 
grams in the comingyear. 

Maple describes Adopt-a-JSR and 
Adopt OpenJDK as "two great programs 
aimed at reducing the barriers to obtain¬ 
ing the average developer's input and 
feedback as early as possible, to benefit 
and direct the future Java releases, code- 
base, and standards. I'm also a member 
of the London Java Community, so I have 
seen both these programs working well. 
It'sourjob asJUG leaders to bringthese 
resources to our members, the indi¬ 
viduals who can participate, which is an 
important step." 



Simon Maple explains the goals of the 
Virtual Java User Group. 
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JAVA.NET POLL 


Jenkins Is the 
Preferred Continuous 
Integration Server 

In a recentjava.net poll, Java and Java Virtual Machine 
(JVM) developers who utilize a continuous integration (Cl) 
server indicated an overall preference for Jenkins. The 
poll, which asked, "Which Continuous Integration (Cl) 
server do you prefer?" was answered by 260 developers. 
Here are the results: 



Pulse Continuum Another 

Cl server 
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Robert Savage, creator 
of the Pi4J project 


PI4J PROJECT 


Robert Savage grew up tinkering with and pro¬ 
gramming Commodore and Tandy computers. 

He has been programming for more than 25 
years, working in the automation industry for 
nearly 15 years. A software architect for AMX, 
Savage says, "It was natural for me to relate to 
the motivations that inspired the Raspberry Pi 
founders." This led Savage to create the Pi4J 
project: "I believed the Raspberry Pi would play 
an instrumental role in helping usherin the 
Internet of Things [IoT]. Also, as a longtime 
consumer of numerous open source platforms, 
frameworks, and tools, I felt called to give back. 


Before Savage created the Pi4J project 
(@ pi 4j). "there were a few other community 
projects that provided Java programmers access 
to the GPIO [general-purpose input/output]," he 
says. "However, these projects provided direct- 
access APIs where the programmer was forced 
to code in a very procedural style. Pi4J's mission 
is to create an object-oriented and event-driven 
API to make working with the Raspberry Pi's I/O 
capabilities more Java-friendly." 

Savage experimented with Pi4J prototypes 
in the summer of 2012. The first Pi4J commit 
to GitHub happened in September 2012. "The 


project has grown steadily since its inception," 
he says. "However, in the past six months there 
seems to be a sharp incline in the number of 
e-mails and forum thread activity." 

At present, there are three principal Pi4J 
developers, and a numberof community mem¬ 
bers contribute fixes and gvf enhancements. The 
current total download count exceeds 15,000. 

Pi4J started out providing simple Java-based 
access to GPIO, but current versions include 
GPIO, RS232, SPI, and I 2 Ccapabilities, as well 
as support for GPIO expanders. The project is 
moving steadily toward an official release of 
Pi4J Version 1.0. For this release, "focus is shift¬ 
ing from raw I/O access to creating higher-level 
component and device interfaces and abstrac¬ 
tions," Savage says. "Rather than program¬ 
mers controlling and interacting with a GPIO 
pin, they can instead create their own reusable 
components. The intent is to abstract away the 
low-level I/O and provide interfaces for working 
with devices and real-world things. It's a work in 
progress, but you can see some examples in the 
'develop' branch in GitHub." 

Savage expects the IoT to bring "an explo¬ 
sion of interesting new devices that will make 
our lives easier through connectivity," he says. 

"I imagine intelligence added to ordinary things 
that ultimately leads to collaboration between 
devices to coordinate a fully automated lifestyle. 
With funding platforms such as Kickstarter 
and Indiegogo, I see a wealth of opportunity for 
independents to build and create." 

You can follow Savage's endeavors on his 
blog or on Twitter (@savageautomate). His 
JavaOne 2013 session, "Let's Get Physical: I/O 
Programming with Java on the Raspberry Pi 
with Pi4J," is also available on Parleys. 
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NightHacking 
Java 8 Tour 


From March 11—April 29, 
Oracle's Java Evangelist extra¬ 
ordinaire Stephen Chin made 
his way through Europe and 
India on the NightHacking 
Java 8 Tour. 

Chin rented a motor¬ 
cycle in Munich, Germany, 
and loaded it up with video 
and demo equipment. He 
motored from Poland to 
Spain, stopping at four con¬ 
ferences and visiting more 
than 20 Java user groups. 

Along the way, Chin live- 
streamed events, hack ses¬ 
sions, and random encoun¬ 
ters and kept everyone 
updated on Twitter. 

Chin wrapped things up 
with a trip to India to attend 
the Great Indian Developer 
Summit in Bangalore, India. 


JAVA CHAMPION PROFILE 

ZORAN SEVARAC 




Zoran Sevarac (right) 
strums a tune with 
fellow Java Champion 
Frank Greco. 

Zoran Sevarac is an 

assistant profes¬ 
sor at University of 
Belgrade, Serbia. He 
was selected to be 
a Java Champion in 
November 2013. 

Java Magazine: 
Where did you 
grow up? 

Sevarac: In Belgrade, 
Serbia. 

Java Magazine: 

When and how did 
you first become 
interested in 
computers and 
programming? 
Sevarac: At the age 
of 12, when I figured 


out how to color 
the TV screen, and, 
even more fascinat¬ 
ing, howto make it 
randomly change 
colors. A few years 
later, I made a space 
shootergame in 
Pascal. 

Java Magazine: What 
wasyourfirst com¬ 
puter and program¬ 
ming language? 
Sevarac: ZX 
Spectrum, Basic. 
Java Magazine: What 
wasyourfirst pro¬ 
fessional program¬ 
ming job? 

Sevarac: I worked 
as a web developer 
in an e-commerce 
startup—Net Link 
Solutions—in Serbia 
with a few friends. 
Nowit has seven 
employees. 

Java Magazine: What 
isyourcurrent job? 
Sevarac: I work 
at the University 
of Belgrade as an 
assistant professor 
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what do you 
* think? 



In the third and final part of the 

Java EE 8 Community Survey, 

each of nearly 4,500 develop¬ 
ers allocated 100 points across 13 
potential Java EE 8 enhancements. 
That's nearly a half million points 
in total. The top selections were 
JSONB (13.7 percent), Security 
Simplification (11.1 percent), JCache (9.5 percent), 
Security Interceptors (8.2 percent), and MVC (model- 
view-controller; 7.8 percent). 

In Parts land 2 of the survey (PDF), developers iden¬ 
tified how important they considered a wide range of 
potential Java EE 8 enhancements, mostly by respond¬ 
ing to questions that could be answered with Yes, No, or 
Not Sure. The 13 enhancements featured in Part 3 of the 
survey were the ones that received 60 percent or more 
Yes responses in the first two parts. 

Looking ahead to Java EE 8, Linda DeMichiel, 
Specification Lead for Java EE 7, says, "The next steps 
for us in this process are to evaluate this input, and 
balance it with feedback from our Java EE licensees, 
the members of our Expert Groups, customers, and our 
internal architects and Specification Leads. Invariably 
this will involve weighing competing opinions and 
balancing competing needs and objectives against the 
resources and time that we have to achieve them." 


ART BY l-HUA CHEN 
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JAVA.NET POLL 


Developers Prefer NetBeans, 
Eclipse, and IntelliJ IDEA 


In a recentjava.net polj, 

93 percent of develop¬ 
ers indicated that they 
do most of their coding 
using NetBeans, Eclipse, 
or IntelliJ IDEA. The days 


of codingjava and Java 
Virtual Machine (JVM) 
languages using text edi¬ 
tors are apparently behind 
us—with good reason! A 
group of 925 developers 


38 % 

Eclipse 


11 % 

IntelliJ IDEA 



participated in the poll, 
which asked them to com¬ 
plete this sentence: "I do 
most of my codi ng usi ng 
_" Here are the results: 

A separate poNasked, 
"How would you like to 
see IDEs evolve over the 
next 2 to 5 years?" 59 
percent of developers 
said they would prefer 
that IDEs remain desktop 
applications, while 30 
percent hoped IDEs would 
adopt a more hybrid form, 
where the IDE is available 
on the desktop but also 
provides a web interface 
(which would be useful for 
global teams orfor when 
developers are traveling). 


1% 

Other 1 % 

Another 

IDE 


4 % 

It depends on what 
I'm working on 
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EVENTS 

DEVOXX UK JUNE 12-13 
LONDON, ENGLAND 

Part of the Devoxx family, the conference is organized by the 
London Java Community. The organizers put developers front 
and center in the conference with their theme "Mind the Geek." 
The schedule is packed with presentations, in-depth hands-on 
labs, 15-minute lunchtime "quickies," and Birds-of-a-Feather 
(BOF) sessions. Developers will meet top British and international 
experts in a casual atmosphere. 


PHOTOGRAPH BY BERIT WATKIN ON FLICKR 
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33rd DEGREE 

)UNE 9-11 
KRAKOW, POLAND 

This conference, which is all about 
Java technology, features seven 
tracks over three days. Conference 
sessions, evening Birds-of-a- 
Feather (BOF) sessions, and three- 
hour-long workshops and labs 
led by world-class trainers are on 
the agenda. 

QCon 

JUNE 9-13 

NEW YORK, NEW YORK 
QCon is designed for technical team 
leads, architects, engineering direc¬ 
tors, and project managers who 
influence innovation in theirteams. 
QCon features a track focused on 
Java innovations, plus tracks on 
mobile, cloud, and much more. The 
first two days are tutorials, followed 
by a three-day conference. 

JAVA EE SUMMIT 2014 

JUNE 23-25 
MUNICH, GERMANY 
Thejava EESummitincludesl4 
intensive workshops about major 
Java EE topics led by top German- 
speakingjava EE experts. Developers 
and software architects will receive 
in-depth knowledge to plan and 
implement successful Java EE 6 and 
Java EE 7 projects. 


FISL 

JULY3-6 

PORTO ALEGRE, BRAZIL 
The International Free Software 
Forum (FISL) eventis jam-packed 
with lectures, workshops, demon¬ 
strations, and presentations. 

UBERCONF EUROPE 

JULY 7-10 
BERLIN, GERMANY 
UberConf, part of the No Fluff Just 
Stuff Software Symposium Series, 
explores the ever-evolving ecosys¬ 
tem of the Java platform. The confer¬ 
ence offers 100 technically focused 
sessions including more than 25 
hands-on workshops centered 
around architecture, cloud, security, 
enterprise Java, languages on the 
Java Virtual Machine (JVM), build/ 
test, mobility, and agility. 

JAVA FORUM 2014 

JULY17 

STUTTGART, GERMANY 
Java User Group Stuttgart (JUGS) 
organizes Java Forum, which is 
attended by more than 1,000 partici¬ 
pants interested in Java and thejava 
environment. The forum includes 
lectures, presentations, workshops, 
demos, and Birds-of-a-Feather 
(BOF) sessions. 
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EVENTS 

LONE STAR SOFTWARE SYMPOSIUM 

JULY 18-20 
AUSTIN , TEXAS 

This conference focuses on the latest 
technologies and best practices emerging 
in the enterprise software development 
space. The java sessions cover trends, best 
practices, and latest developments in Java 
application development. The conference 
features more than 55 sessions with lead¬ 
ing industry experts, who share their prac¬ 
tical and real-world experiences. 

OSCON 

JULY 20-24 
PORTLAND , OREGON 

Open source pioneers, experts, and inno¬ 
vators have gathered at OSCON over the 
past 16 years. With a dozen tracks and 
hundreds of sessions, the conference has 
practical tutorials, inspirational keynotes, 
and a wealth of information on open 
source languages and platforms. 

THE DEVELOPER'S CONFERENCE (TDC) 

JULY30-AUGUST3 
SAO PAULO, BRAZIL 

One of Brazil's largest conferences for 
developers, IT professionals, and students, 
this event offers Java tracks over five days. 
Java-focused content includes introductory 
sessions in the Java University track, and 
advanced and intermediate sessions in the 
Java EE, mobile, and embedded tracks. 


JAVA BOOKS 



IAVA 8 POCKET GUIDE 

By Robert Liguori and 
Patricia Liguori 
O'Reilly, April 2014 
Here's Java, stripped down 
to its bare essentials: pos¬ 
sibly the only book on Java 
thatyou can actually fit 
in your pocket. If you've 
ever been writing code 
and gotten stuck because 
you can't remember how 
something works, the Java 
8 Pocket Guide is an indis¬ 
pensable aid. This edition 
focuses on Java 8, includ¬ 
ing sections on lambdas 
and the Date and Time 
API. This book offers prac¬ 
tical help for practicing 
developers. 
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JAVA PROGRAMMING 

INTERVIEWS EXPOSED 

By Noel Markham 
Wiley, February 2014 
Java is virtually a require¬ 
ment for businesses 
making use of IT in their 
daily operations. For Java 
programmers, this real¬ 
ity offers job security 
and a wealth of employ¬ 
ment opportunities. But 
that perfect Java coding 
job won't be available if 
you can't ace the inter¬ 
view. If you are a Java 
programmer concerned 
about interviewing, java 
Programming Interviews 
Exposed is a great resource 
to prepare you for your 
next opportunity. Author 
Noel Markham, an experi¬ 
enced Java developer and 
interviewer, has loaded his 
book with real-world inter¬ 
view examples. 



MASTERINGJAVAFX 8 

CONTROLS 

By Hendrik Ebbers 
Oracle Press, July 2014 
This Oracle Press guide 
shows how to create cus¬ 
tom JavaFX 8 controls and 
masterthe development 
of rich clients and huge 
applications. It introduces 
JavaFX controls and the 
basic JavaFX APIs for han¬ 
dling them. It then reviews 
available controls and 
provides clear instructions 
on howto alterthem as 
wel I as how to create new, 
custom controls speci¬ 
fied to the user's needs. 
Developers new to JavaFX 
and those ready to start 
advanced work will benefit 
from this book. 




































JCP Executive Series 



W erner Keil has 

worked for more 
than 25 years as 
a project manager, soft¬ 
ware architect, analyst, 
build manager, agile coach, 
and consultant for various 
Fortune Global 500 compa¬ 
nies, including Oracle and 
IBM, across diverse indus¬ 
tries, such as mobile/telco, 
Web 2.0, finance, insurance, 


Java Tools for 
the Bottom Line 


Individual Executive Committee member Werner Keil 
discusses the Java Money and Currency API, and his unique 
participation in the JCP. BY STEVE MELOAN 


travel, automotive, health¬ 
care, media, and public 
services. Among his early 
clients was Sony, where he 
designed and implemented 
microformat-based tags for 
its online music portals. 

Keil develops enterprise 
systems using Java and 
other technologies from 
Oracle, IBM, and Microsoft, 
and does web design and 
development using Adobe 
products, Ajax/JavaScript, 
and dynamic and func¬ 
tional languages. 

Keil is a Committer at the 
Eclipse Foundation; a Babel 


PHOTOGRAPHY BY TON HENDRIKS 
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usage scenarios, a plain-text represen¬ 
tation of money, and printing and pars¬ 
ing to String. 

We wanted to make the API very flex¬ 
ible with the ability to define custom 
currencies, either in a gaming environ¬ 
ment or to accommodate the rise of 
virtual currencies. 

Also, size was a key concern. This API 
needs to be applicable in the Java ME 
world, running on a money-changing 
box for instance, all the way up to a 
large server running Java EE. Scalability 
is hugely important. And I think we 
achieved that. 

Java Magazine: When processing 
money, security is paramount. Will you 
talk about that aspect? 

Keil: Security is certainly a key issue. 
But the Java Money and Currency API, 
as such, is not responsible for this 
aspect. Monetary data must rely on 
other functionalities of the Java plat¬ 
form to provide a trusted environment. 
Java SE's security APIs handle cryptog¬ 
raphy, secure communication, authen¬ 
tication, access control, and public key 
infrastructure. Users and administra- 


Keil and Anatole Tresch, 
Specification Lead for 
JSR 354, talk with 
Stephen Chin for the 
NightHacking tour 
during the JavaLand 
conference in Briihl, 
Germany. 


Language Champion; a UOMo Project 
Lead; and an active member of the Java 
Community Process (JCP), where he is 
a member of the Executive Committee. 
In addition, he is involved in manyJSRs 
and open source projects, runs his own 
creative and talent agency—Creative 
Arts &r Technologies—and writes song 
lyrics, novels, screenplays, technical 
boohs, and articles. 


Java Magazine: Give us a quick over¬ 
view of JSR 354, the Java Money and 
Currency API. 


Keil: JSR 354 provides inter¬ 
faces and classes designed 
to handle currencies and 
monetary data. There are 
four main areas of focus. 

The Core defines classes 
representing currency data 
and monetary amounts. 

The Conversion module 
provides APIs and service 
provider interfaces (SPIs) to 
convert from one currency 
to another, and it handles 
exchange rates between 
currencies. The Format module sup¬ 
ports the parsing and formatting of 
currency data through a set of APIs and 
SPIs. And the Extensions module offers 
functionality such as regional support, 
validity services, and currency mapping. 

The Money and Currency API targets 
all general application domains such 
as banking and finance, e-commerce, 
and mobile or embedded payments. 

It supports complex calculation rules, 
including regional algorithms and cor¬ 
responding display precision. There is 
also logic for foreign exchange, complex 


A FLEXIBLE API 

We wanted to make the API very flexible with the ability to 

define custom currencies, either in a gaming environment 
or to accommodate the rise of virtual currencies. 
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Keil and Oracle’s 
Ed Burns look at 
Money and Currency 
API details during 
JavaLand. 


REAL-WORLD API 

This API needs to 
be applicable in 

the Java ME world, 

running on a money- 
changing box for 
instance, all the way 
up to a large server 
running Java EE. 




tors are also provided a set of tools 
for securely managing applications. I 
was involved in JSR 321, the Trusted 
Computing API for java, which was 
designed to access Trusted Computing 
functionality from java applications. 
Members of the Executive Committee 
have to be cognizant of usage sce¬ 
narios to ensure that financial transac¬ 
tions cannot be intercepted or dupli¬ 
cated. These are crucial issues in the 
security landscape. 

Java Magazine: Are lambda expressions 
supported by the Money and Currency 
API? 

Keil: The Money and Currency API is 
not directly tied to the APIs of java 8. 
Many enterprise customers will use the 
JDK that is included with their applica¬ 
tions server, and for a while that will be 
Java SE 7. So we have to be backward 
compatible. But we use many of the 
Java 8 functional interfaces in a pattern 
and signature that will be compatible. 
Lambda expressions built into the API, 
however, will probably not be feasible 
until at least Java SE 9. 

Java Magazine: Tellusaboutyour 
involvement with the JSR 354 process. 
And what is the current status of 
the API? 

Keil: I was influential in the genesis of 
this JSR. It first came up during a panel 
discussion at QCon in London seven 
years ago. There was general agree¬ 


ment that a JSR targeted at money and 
currency would be very useful. And 
we talked about some of the logistics 
regarding how it would mesh with 
future Java releases. 

Five years ago, when I was already a 
member of the Executive Committee, 
we had a face-to-face meeting in 
Princeton, where I did a presentation 
on units of measurement in support of 
JSR 275. While that effort was stopped 


at the JCP phase, parts of it inspired 
subsequent work on JSR 354. 

Credit Suisse joined the Executive 
Committee soon after that, and under¬ 
stood the value of a currency and 
money JSR. Anatole Tresch, from Credit 
Suisse, stepped in as Specification Lead 
and has done a fantastic job. We expect 
Public Review 2 in the second quarter 
of this year. If that passes, and the JSR 
is viewed as feature-complete, a final 
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Tresch and Keil 
take a break 
between sessions 
at JavaLand, where 
they were both 
speakers. 


version might be ready around the 
JavaOne time frame. 

Java Magazine: How does your involve¬ 
ment with the Eclipse Foundation 
influence your work within the JCP? 
Keil: JSR 275 was a general-purpose 
measurement effort. But at the time, 
back in 2010, it was viewed as a too- 
small niche for the Java platform. So as 
Specification Lead, I pursued the con¬ 
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JSR 354 TIMELINE 

We expect Public Review 2 in the second quarter of 
this year. If that passes, and JSR 354 is viewed as 
feature-complete, a final version might be ready around 
the JavaOne time frame. 


cepts in an open source project called 
unitsofmeasurement.org, which is a 
library that provides Java interfaces for 
handling units and quantities. The proj¬ 
ect design benefited from comments 
from Executive Committee members— 
some of whom voted against JSR 275. 

So the new work is improved and is 
different from the old JSR. The revital¬ 
ized project was implemented by an 
open source project called UOMo under 
the Eclipse umbrella, and is led by me. 

It allows developers to convert between 
various systems of measurement, and 
to format or parse string representa¬ 
tions of units. 

A couple of months ago, I discussed 
reviving a JSR to ensure that the work 
we've done with unitsofmeasure- 
ment.org and UOMo can be used in 
a new JSR that will add value to Java, 
for example, making it comparable to 
languages such as C/C++ in this regard. 
This was proposed to the JCP Program 
Management Office, and has now been 
filed as JSR 363.1 think this JSR will be 
particularly useful for embedded Java 
applications supporting the evolving 


Internet of Things space, which will 
spawn unbelievable volumes of data 
that need interoperability. 

So, this is an excellent example of 
how the JCP and open source efforts, 
such as those of Eclipse, can inter¬ 
act and add value for all the parties 
involved. It's a vibrant ecosystem that 
produces innovation. 

Java Magazine: You are the only inde¬ 
pendent member of the JCP Executive 
Committee. How is your involvement 
unique? And what motivated you to join? 
Keil: In 2008, a few months after I left 
BEA as an independent contractor, I 
became a candidate for the Executive 
Committee. I got the most votes of all 
the individual candidates on the Java 
SE side, thanks to my broad experi¬ 
ence and my history of participation 
in JCP activities. I had been a member 
of a couple of Expert Groups and was 
asked to help JSR 275 as one of the 
Specification Leads. 

My varied experience as an inde¬ 
pendent contractor gave me a unique 
view of the Java landscape from many 
different angles, ranging from Java EE 





























Keil talks with Terrence 
Barr, senior technologist 
and product manager 
at Oracle. 


and large portals to embedded Java on 
small devices. I try to bring these expe¬ 
riences into my Executive Committee 
participation. 

I originally joined the JCP because I 
wanted to contribute toward making 
the Java platform as robust and compet¬ 
itive as possible. We all depend on these 
tools to bring our ideas to fruition, so we 
need to be sure that the best solutions 


become part of the technology. 

Java Magazine: How can we increase 
independent participation in the JCP? 
Keil: JSR 358, with Oracle's Patrick 
Curran as Specification Lead, makes 
a number of important revisions 
and adjustments to the JCP. Revising 
the Java Specification Participation 
Agreement [JSPA] is a major focus for 
this JSR, which should have a posi¬ 
tive impact on JCP participa¬ 
tion. Sometimes employers 
are reluctant to participate, 
because the JSPA has intellec¬ 
tual property and patent impli¬ 
cations that can be problematic 
for some companies. 

One possibility is to fol¬ 
low the lead of the Eclipse 
Foundation and allow develop¬ 
ers to get involved as individu¬ 
als, apart from their employer, 
with a designation of affiliate or 
associate. This would involve a 
separate agreement that typi¬ 
cally allows a developer to con¬ 
tribute ideas without interact¬ 
ing directly with code. This type 
of membership should have a 
positive impact by simplifying 
the legal agreement and the 
role. The goal is to avoid any 
patent or intellectual property 
disputes that might arise from 
work done for the JCP. 


JCP.next is a group of JSRs (includ¬ 
ing JSR 358) dedicated to improving 
JCP processes. We hope to increase 
participation by individuals who are 
self-employed, or are members of a 
Java user group [JUG], or work at a 
university. And we also plan to improve 
participation through the use of open 
source development processes and 
public mailing lists. 

Java Magazine: Any closing remarks? 
Keil: I hope the Executive Committee 
will always have some independent 
members, individuals, and/or JUGs. 
More diversity of background and expe¬ 
rience increases innovation and prob¬ 
lem resolution. And that contributes to 
the overall quality and viability of the 
Java platform. </article> 


Steve Meloan is a former C/UNIX soft¬ 
ware developer who has covered the web 
and the internet for such publications as 
Wired, Rolling Stone, Playboy, SF Weekly, 
and the San Francisco Examiner. He 
recently published a science-adventure 
novel, The Shroud, and regularly 
contributes to The Huffington Post. 


/ LEARN MORE 

• JSR 354: Money and Currency API 

• JSR 354 project page on 1ava.net 

• NightHacking interview 
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Your Destination for Java Expertise 


Just in time for the Java SE S launch, these new Oracle Press books offer the 
most definitive, complete, and up-to-date coverage of Java available. 





Java 

The Compete Reference 
Nihto Edffj'on 






ORACLE 
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Mastering Java FX B 
Controls 
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Java 

^ Bagrnner'js Guide 
Sixth Edition 
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Java: The Complete 
Reference, Ninth Edition 

Herbert Schlldt 


Java: A Beginner’s Guide, 
Sixth Edition 

Herbert Schfldt 


Mastering JavaFX 8 
Controls 
Hendrfk Ebbers 


Quick Start Guide to 
JavaFX 
J.F. DIMarzlo 


Fully updated for Java SE 8, this 
definitive guide explains how to 
develop, compile, debug, and run 
Java programs. 


This fast-paced Java programming 
tutorial is revised to cover Java SE 8. 


Get a thorough introduction to 
JavaFX controls and the basic 
JavaFX APIs to handle them. 


Create and deploy dynamic 
enterprise client applications 
in no time. 


Oracle 
Press m 


Available in print and as eBooks 


Visit us at OracloProssBooks.com • Follow us 


@OracloPross and Llko us f OracloPross 


















Pinkmatter Cofounder 
and Chief Software 
Architect Chris Bohme 
at the South African 
National Space Agency 
satellite receiving station 


TRANSFORMING DATA 
INTO INFORMATION 

A portfolio of Java applications from South African software house Pinkmatter 
Solutions helps turn seemingly unrelated data into useful information. BY PHILIP J. GILL 

PHOTOGRAPHY BY JAMES OATWAY/GETTY IMAGES 


P retoria, South Africa-based software 
house Pinkmatter Solu t ions boasts 
a diverse product portfolio: there's 
Maltego, an open source intelligence and 
data gathering suite; FarEarth, a satel¬ 
lite image processing, enhancement, and 
analysis tool; and Phoenix, a text min¬ 
ing and document linkage engine. At first 
glance, these solutions seem to have noth¬ 
ing in common, except that they are all 
written in Java. 
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PINKMATTER 

SOLUTIONS 

pinkmatter.com 

Location: 

Pretoria, South Africa 

Industry: 

Software 

Employees: 

8 

Java technologies 
used: 

JDK, the NetBeans 
Platform, NetBeans 
IDE 



On closer inspection, however, it 
becomes clear that for all their differ¬ 
ences, these applications have a com¬ 
mon purpose—helping users make 
connections between seemingly ran¬ 
dom pieces of data, linking them by 
group, type, or other characteristics, 
and then presenting them graphically 
in ways that can reveal potentially valu¬ 
able information. 

"On the internet, there's lots of infor¬ 
mation—names, IP addresses, e-mail 
addresses, and so on—that in isola¬ 


tion don't tell you very much," explains 
Chris Bohme, Pinkmatter's cofounder 
and chief software architect. "But when 
you discover links between them and 
present them in a graphical way, it can 
get very interesting." Bohme notes 
that Maltego does just that—no illegal 
snooping or invasion of privacy needed. 

"The information is out there in the 
open," Bohme continues. "Customers 
can of course add their own informa¬ 
tion, but when we call Maltego an 
'open source intelligence' tool, we 


mean the information that it uses is 
openly available in public sources on 
the internet, not that it's licensed as 
open source software." 

As an example, Bohme mentions a 
somewhat notorious celebrity socialite 
who frequently posts images on Twitter. 
"It's pretty easy to find her home 
address in just a few mouse clicks based 
on the pictures she tweets, because 
there are GPS coordinates inside those 
pictures" he says. "In five mouse clicks, 
you can have her home address." 
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A Maltego screenshot While that may be fun for fans and 

shows tweets and the paparazzi, law enforcement and 

followers of Paterva. businesses around the world also use 

Maltego for far more serious matters. 

In the banking industry, for example, 
Maltego is used as a computer forensics 
tool to help ferret out fraud. "Maltego 
can link internet IP addresses to bank 
accounts, so that in the case of sus¬ 
pected bank fraud or money launder¬ 
ing, it can graphically depict where 
money was deposited and what account 
received money from that account, and 
follow the trail," says Bohme. 

Maltego, written in Java on the 
NetBeans Platform, uses what the com¬ 
pany calls "transforms" to link one type 
of information item—names, compa¬ 
nies, e-mail or IP addresses, websites, 
and so on—to another and to pres- 
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ent those links graphically 
in diagrams that resemble 
computer network sche¬ 
mas. "Maltego uses a form 
of type matching and merg¬ 
ing of entities," says Bohme. 
"There's no AI or learning 
algorithm in that sense." 

Maltego is developed for 
another South African com¬ 
pany, Paterva, which markets, 
supports, and has managed 
to establish the product 
worldwide. Maltego licenses 
are currently in use in a vari¬ 
ety of industries for intel¬ 
ligence and security applica¬ 
tions, and a free community 
edition with limited function¬ 
ality currently has 180,000 
registered users. 

PICTURING CHANGES 

After successfully building 
Maltego, the Pinkmatterteam 
looked around for another 
opportunity and found one 
in satellite image processing 
and enhancement. Their sec¬ 
ond product, called FarEarth, 
is a suite of Java applica¬ 
tions that is also built on the 
NetBeans Platform and is 
aimed at space agencies. 

The first component in the 
FarEarth suite was originally 
created for the South African 
Nationals pace Agency, and 


NetBeans 
IDE 8 Arrives 


Oracle has released NetBeans 
IDE 8, the newest version of the 
popular Java open source inte¬ 
grated development environment 
(IDE). NetBeans 8 features improved support for 
Maven, Java EE with PrimeFaces, PHP, and C/C++, 
and new tools for FITML5, including AngularJS. 

“NetBeans 8 has a number of nice updates to its 
code editing features,” says Chris Bohme, cofounder 
and chief software architect at Pinkmatter Solutions 
in Pretoria, South Africa. Pinkmatter’s Maltego 
solution, an open source intelligence and security 
matrix suite, makes use of the new NetBeans 
functionality—which includes new out-of-the-box 
code analyzers and editors. “We use the code edi¬ 
tor inside Maltego so that users can author macros 
called Maltego Machines that can automate many 
tasks users would otherwise do by hand,” says 
Bohme, offering automatic monitoring and footprint¬ 
ing of an organization’s infrastructure or monitoring 
activity on Twitter as examples. 

“NetBeans 8 is more than an IDE; it is also an 
application framework known as the NetBeans 
Platform,” adds Geertjan Wielenga, principal product 
manager for NetBeans at Oracle. “The NetBeans 
Platform is a generic application framework for Java 
desktop applications that provides the infrastructure 
plumbing that every developer needs out of the box, 
so that they don’t need to manually code these or 
other basic features themselves.” 

NetBeans 8 was released simultaneously with 
JDK 8 and works seamlessly with Java SE 8, 

Oracle Java SE Embedded 8, and Oracle Java ME 
Embedded 8. 
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A FarEarth Observer screenshot 
shows swamps near Lake Manyeke 
in Southern Zambia as seen by the 
Landsat 8 satellite. 

today four other countries—Nigeria, 
Indonesia, Germany, and Australia— 
use FarEarth components for applica¬ 
tions such as environmental monitor¬ 
ing. "Images produced by the FarEarth 
system are used in forest monitor¬ 
ing, agriculture, and water manage¬ 
ment," says Bohme. "In Indonesia, for 
instance, there's a big push to get as 
many images as they can to see how 
their rain forests degrade and recover 
overtime." 

Bohme mentions in particular a 
United Nations-sponsored project 
in developing countries called REDD, 
which is short for Reducing Emissions 
from Deforestation and 
Forest Degradation. 

REDD gives money 
to countries to look 
after their rain for¬ 
ests, "to help preserve 
and restore them," he 
explains. "Some of our 
customers use FarEarth 


images to apply for funds under the 
REDD program." 

The FarEarth system receives raw 
satellite image data in real time and 
renders it one line at a time. "The color 
bands are not aligned when you get 
them, so what you see is smudges," 
says Bohme. "Through many, many 
steps, we create a clear image by apply¬ 
ing geographic and geometric correc¬ 
tions and aligning the eight different 
spectral bands—so that all the colors 
look normal." 

The next step in the process is to 
take raw Landsat images of the same 
land areas over time and then compare 
and analyze those images against each 
other for changes on the ground, iden¬ 
tifying potential threats to greenbelts 
and forests. 

Once processed and enhanced 
through FarEarth, the images are stored 
and cataloged for later retrieval and 
analysis by the public, scientists, and 
government departments and agencies. 

"You can look at each pixel over the 
years and use that as a scientific mea¬ 
surement," says Bohme. "From these 
images you can see actual changes; in 
the winter the trees in 
a forest are brown and 
dark, and in the sum¬ 
mer they're light green, 
for example. You can 
also look at images of 
the same land area 
from year to year and 
see what changes have 


MAGICAL NAMESAKE 

The precursor to Maltego 

was named “Palantir,” after 
a magical object in the film 
The Lord of the Rings. 
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Bohme at his office in 
Pretoria, South Africa 


occurred on the ground by analyzing 
the differences in the images. To have 
all this done fully automated is what we 
are working towards." 


TEXT AND BIG DATA 

A third Pinkmatter prod¬ 
uct, called Phoenix, is 
currently in develop¬ 
ment, with a beta ver¬ 
sion expected later this 
year. Written in Java, 
Phoenix employs a full 
suite of Apache open 
source technology for big 
data applications, includ¬ 
ing Hadoop, HBase, and 
Elasticsearch. 


CLIMATE DEFENDER 

The United Nation’s 
REDD program has 

spent more than 
US$170 million fighting 
climate change in 
developing nations. 


"Phoenix does 
big data mining 
on large volumes 
of documents and 
then visualizes how 
the information in 
those documents 
fits together," says 
Bohme. "It uses a 
functionality we call 
'disambiguation.' If 
you have one docu¬ 
ment that mentions 
John Smith and 
another mentions 
John Smith, how do 
you know if it's the 
same John Smith or 
not?" With Phoenix, 
Bohme explains, "We 
scan the documents and build a data¬ 
base of the information. We have learn¬ 
ing models that actually decide whether 
this John Smith is the same or different." 

Atypical application of Phoenix 
might take place in a law firm or the 
legal department of a 
large corporation. "From 
a bunch of legal docu¬ 
ments, we extract infor¬ 
mation and create a 
Maltego-like graph that 
would show who owns 
what, for example," 
Bohme says. "All that 
information is auto¬ 
matically learned and 
extracted from the docu¬ 


ments without human beings having to 
read thousands of pages." 

For all these applications, Bohme 
says, Java was the only choice. "I had 
programmed in C#, Java, C++, and 
other languages back in 'the good old 
days' when I was doing cryptography," 
Bohme recalls of the years before he 
started Pinkmatter with cofounder 
Sonja Goosen. "But Java was always my 
favorite language, and I fell in love with 
it from the start." 

In addition to being his favorite, Java 
had two technological advantages— 
and still does—over other languages 
such as C#, says Bohme. The first is 
platform independence. 

"At the time we started Pinkmatter, 
people talked about C# that way, but 
that was really a pipe dream," he says. 
"The only strongly typed language that 
gave us real platform independence on 
the Mac, BSD, Linux, and Windows was 
Java, and it still is." 

The second advantage is the 
NetBeans Platform. "Having an appli¬ 
cation framework that gives you auto¬ 
updates, runtime composition, loadable 
modules, a wonderful window manage¬ 
ment framework, and other important 
features right out of the box wasn't 
matched by Microsoft and C# then and 
still isn't," notes Bohme. </articie> 


Philip J. Gill is a San Diego, California- 
based writer and editor who has followed 
Java technology for more than 20 years. 
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Parti 

Interactive Objects with BlueJ 

Interactivity and visualization help beginners learn and form mental models. 


MICHAEL KOLLING 

p 


Development 
Tools and 
Techniques 


PHOTOGRAPH BY JOHN BLYTHE 


W hen you talk with 

people about learning 
to program, and especially 
learning to program in java, 
the BlueJ environment is 
often mentioned as a good 
introductory environment to 
get started. And with good 
reason: BlueJ is an 
excellent environ¬ 
ment in which to 
gain a good under¬ 
standing of funda¬ 
mental principles 
of object-oriented 
programming. 

When asked why 
beginners should 
not just start by 
using Eclipse or 
NetBeans— 
environments 
known for their 
excellent toolset 
and great 
functionality—the 
answer typically 
points to the great 
value of BlueJ's sim¬ 
plicity and interac¬ 


tivity for gaining a thorough 
understanding of program¬ 
ming principles. 

But what does this really 
mean? 

When talking about BlueJ, it 
is not immediately clear what 
we mean by interactivity, nor 
is it clear why that 
matters. In this 
two-part series 
of articles, we will 
explore and discuss 
BlueJ's interactive 
features in detail to 
see what they can 
do for you and why 
you should care. 

It's Not About 
Syntax 

Learning to pro¬ 
gram is not about 
syntax. Well, at 
least not mainly 
about syntax. 
Learners new to 
programming often 
struggle to get their 
semicolons in the 


BEYOND SYNTAX 


Learning to 
program is 
notabout 
syntax. Well, at 
least not mainly 
about syntax. All 
of us who have 
been around 
programming for 
a while know that 
syntax is neither 
the interesting 
nor the hard part. 


right places, match their curly 
brackets, or remember the 
syntax of a for loop. They often 
think that this is what pro¬ 
gramming is about: learning 
to get the syntax right. But of 
course it isn't. 

All of us who have been 
around programming for a 
while know that syntax is 
neither the interesting nor the 
hard part. In fact, every stu¬ 
dent at the university where I 
teach will eventually learn the 
syntax of their first program¬ 
ming language. It seems hard 
to some of them at first, but 
it's actually the easy part. 

No; programming—in this 
case, object-oriented 
programming—is about 
learning how to translate 
your problem into a program 
structure, how to design your 
object interactions, and how 
to structure your classes. It is 
about designing algorithms 
and interacting object struc¬ 
tures. And this is hard. 

To do this effectively, it is 


crucial to have a well- 
developed mental model of 
object interactions—both 
how they work in general and 
how they are arranged in the 
particular program you are 
working on. 

And this is the crucial dif¬ 
ference between beginners 
and experts: experts have a 
well-developed mental model 
of the fundamental principles 
of object orientation, while 
beginners do not. Beginners 
need to develop this mental 
model, and an educational 
programming environment 
must help learners do so. 

Environments for Experts, 
Environments for Learners 

Environments designed for 
professionals—NetBeans, 
Eclipse, and the like—work 
very well for experts. They 
provide a great toolset for 
programmers who know what 
they are doing, but they do 
little to help learners develop 
the mental models they need 
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to become good programmers. 

The main focus in these environ¬ 
ments is on source code. Beginners 
using these systems stare at lines 
of code, so it is not surprising that 
what they think about is lines of 
code. Yet, what is really much 
harder, and much more impor¬ 
tant, to learn are the fundamental 
abstractions: classes, objects, and 
interactions. These are not well 
represented in professional envi¬ 
ronments. Objects, for example, 
hardly exist as a tangible abstrac¬ 
tion in a typical interface. Students 
look at lines of java code and strug¬ 
gle to understand the difference 
between classes and objects. 

This is not a problem for prac¬ 
ticed program¬ 
mers, because 
they have a work¬ 
ing model in their 
minds. However, 
for beginners this 
is a fundamen¬ 
tal problem—a 
much harder 
and more fun¬ 
damental one 
than the ques¬ 
tion of where 
the semicolons 
go—and they get 
no help from the 
environment. 

An educational 
development 


environment must help learn¬ 
ers develop the mental models 
needed, and it must put the impor¬ 
tant abstractions—classes, objects, 
and method calls—in front of the 
students' eyes and let them think 
and talk about them. 

And this is exactly what Blue] 
does. That is why starting with Blue] 
will give beginners a stronger foun¬ 
dation in programming principles. 
Once they have developed a good 
working model of object-oriented 
program execution, they are ready 
to leave BlueJ behind and switch 
to a professional environment. But 
a programmer without a strong 
foundation in the fundamental 
principles is a dangerous thing. 

A Few Words About Simplicity 

At the beginning, we mentioned 
simplicity and interactivity as the 
two important points. Simplicity is 
the easier one to discuss; it is easy 
to see, and most people get the 
point quickly. 

Professional environments offer 
many tools that are helpful, and 
often essential, for experts, but 
these can easily become a hin¬ 
drance, rather than help, for learn¬ 
ers. Beginners use only a small 
fraction of these tools, but they 
initially don't know which fraction 
they need to use. Finding the right 
workflow is made harder by the 
presence of unwanted options, and 


STARTER KIT 


BlueJ is designed 
to offer just the 
right toolset 
for beginning 
programmers. It 
appears simple, 
yet does 
sophisticated 
things to help 
them work and 
learn. 
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Viewer 



Figure 1 


orienting yourself in the environ¬ 
ment is distinctly difficult on your 
first encounter. 

Choice, for people who don't 
need it, is a bane, not a favor. 

Blue] is designed to offer just the 
right toolset for beginning pro¬ 
grammers. It appears simple, yet 
does sophisticated things to help 
them work and learn. After only a 
short time, users feel comfortable 
in the environment and feel they 
know it well, and Blue] blends into 
the background. Learners don't 
need to think about the environ¬ 
ment; they think about program¬ 


ming principles. The development 
environment becomes a silent 
helper, not a problem to be mas¬ 
tered in itself. 

Bluej's interface (see Figure 1) 
appears very simple and unthreat¬ 
ening. This should not be mistaken 
as simplicity of functionality: Blue] 
offers some sophisticated tools 
that help learners along the way, 
and we will discuss some of them 
shortly. In fact, one of the greatest 
achievements of Blue] is to present 
a complex problem domain- 
programming—in a simple fash¬ 
ion. One of the leading design 
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goals of Blue] is well expressed in a 
famous quote by Antoine de Saint 
Exupery: 

"Perfection is achieved, not 
when there is nothing more to add, 
but when there is nothing left to 
take away." 

But it is also important to note 
that this does not mean that an 
educational environment is simply 
a cut-down version of a profes¬ 
sional one. BlueJ's toolset is not 
a subset of one of the bigger sys¬ 
tems. It is not merely about offer- 
ing/ewertools, but about offering 
different ones. 

Blue] has various bits of func¬ 
tionality not found in many other 

\ ~ I 
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Figure 2 
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environments, and most impor¬ 
tant among them is a greater level 
of interactivity and visualization. 
These are the important tools for 
learning to program and forming 
your mental models, and, there¬ 
fore, they will be the focus of the 
rest of this article. 

The Killer Features: Interaction 
and Visualization 

A previous issue of Java Magazine 
introduced BlueJ's features by pre¬ 
senting a small programming exam¬ 
ple, and another issu e discussed 
testing in Blue] in more detail. 

Both of these articles touched 
on BlueJ's interactive features 
and made use of some of them. 
However, they presented only a par¬ 
tial insight into BlueJ's toolset. We 
will now discuss BlueJ's interaction 
features in more depth—the first 
few here, and the rest in Part 2. 

Classes and Objects 

The first, most obvious—and 
most fundamental—aspect of 
BlueJ's functionality that is rel¬ 
evant here is its presentation of 
classes and objects. 

When opening Blue], the first 
thing shown to a user is a diagram 
of the classes in the project and 
their relationships. The diagram's 
arrows display inheritance and uses 
relationships— which is when a 
class references another. 
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A user can then inter¬ 
actively create objects 
by right-clicking any of 
the classes and invoking 
a constructor from the 
class' menu (see 
Figure 2). Every con¬ 
structor of the class is 
shown in this menu 
and can be interactively 
invoked. Objects, once 
created, are shown in 
red on the object bench 
along the bottom of 
the main window (see 
Figure 1). 

Once an object has 
been created, a menu 
offers all the object's 
public methods, and 
any of them can be 
interactively invoked by 
selecting it from this 
menu (see Figure 3). If 
the method has parameters, they 
can be entered; otherwise, the 
method executes immediately. 

Why Is This Important? 

Even the first few simple visualiza¬ 
tions and interactions shown so far 
have a fundamental effect on the 
understanding of the principles of 
object orientation. 

First, the division of a program 
into classes is illustrated. The dia¬ 
gram conveys the message that an 
object-oriented program is repre¬ 


sented by a set of coop¬ 
erating classes, and 
that these parts of a 
program can be exam¬ 
ined and understood 
separately. Presenting 
the classes in a diagram 
illustrates their relation¬ 
ship better than the 
simple list used in many 
other environments. 

Second, the dif¬ 
ference between 
classes and objects is 
implicitly apparent. 
Understanding this 
difference is one of 
the great problems for 
beginning students. 
Most teachers have 
struggled with this. In 
traditional environ¬ 
ments, students start 
by looking at source 
code. What do they see—a class 
or an object? Well, the answer is 
neither or both. Which one it is 
depends on context: whether the 
student thinks about the static or 
dynamic properties of their pro¬ 
gram. Understanding the difference 
is difficult. 

In BlueJ, the distinction is imme¬ 
diately clear: from a class, we can 
create objects. In fact, we can cre¬ 
ate as many objects as we like. In 
BlueJ, the question never comes up. 
Students get a feeling for classes 


BlueJ has various 
bits of functionality 
not found in many 
otherenvironments; 

most important 
among them is a 
greater level of 
interactivity and 
visualization. 
These are the 
important tools for 
learning to program 
and forming your 
mental models. 
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and objects almost auto¬ 
matically, with little effort. 

Both the visualization and 
the interaction (the act of 
creating the object) sup¬ 
port this understanding. 

Third, it becomes 
immediately clear that we 
can communicate with 
objects by invoking their 
methods. Students can 
experiment with objects, 
try out what they do, gain 
experience with param¬ 
eters and return values, 
and investigate a project 
or parts of a project. The 
understanding developed 
through these activities 
will be very useful once students 
start writing code. 

Understanding object orientation 
is about understanding three big 
concepts that define objects: state, 
behavior, and identity. Even these 
first simple interactions already 
illustrate two of them: behavior 
and identity. (We will soon see how 
state is visualized.) 


(and also students) can 
become active before 
writing code. Easier and 
quicker interaction means 
more interaction. More 
interaction means better 
understanding. 

The possibility of inter¬ 
action fundamentally 
changes how a learner 
can approach gaining an 
understanding of pro¬ 
gramming principles. 

Conclusion 

The use of visualization 
and interaction leads to 
the formation of bet¬ 
ter and stronger mental 
models that then form the basis 
for reasoning about programs and 
programming. So far, we have seen 
only a small example of Bluej's 
visualization and interactive fea¬ 
tures. In the next article, we will 
discuss many more tools that sup¬ 
port this process. </article> 

MORE ON TOPIC: 



iluejisan 
excellent 
environment 

in which to 
gain a good 
understanding 
of fundamental 
principles of 
object-oriented 
programming. 


No Test Drivers 

One of the important aspects to 
emphasize about Blue] is ease of 
interaction: methods can be exe¬ 
cuted individually without the need 
to write any test drivers. No public 
static void main is necessary. This 
means that classes and objects 
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• Download Blue] for free 

• Example projects at the Blue] book 

website 
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DEVELOPER TOOLS 
AND TRENDS 

Oracle’s Chris Tonas talks about Java tools and development frameworks. 

BY TORI WIELDT 

PHOTOGRAPHY BY BOB ADLER/GETTY IMAGES 


Development 
Tools and 
Techniques 


N othing starts aflame-fest like a discussion 
of IDEs. Developers have religious-like fer¬ 
vor about the best IDE to use—or whether 
to use an IDE ("Emacs is all I need!''). It's obvi¬ 
ous that one size doesn't fit all, but what tools 
can help most java developers ? What is Oracle's 
role in developer tools as the steward of java and 
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Chris Tonas (left) and 
SundarSarangan, 
member of the 
technical staff at 
Oracle, talk about 
development for small 
devices and tablets. 


NetBeans IDE and as the creator of 
Oracle JDeveloper? What are the signifi¬ 
cant trends that are shaping software 
development and tools? 

Java Magazine sat down with Oracle's 
vice president of mobility and applica¬ 
tion development tools, Chris Tonas, 
to hear his take on the latest in the 
world of Java tooling and development 
frameworks. 

Java Magazine: Can you tell us a little bit 
about your role at Oracle as it relates to 
development tools? 


Tonas: I lead the organization that is 
working on Oracle's software develop¬ 
ment tools and frameworks, specifically, 
the teams that build our offerings for 
Java developers—whether in NetBeans, 
Eclipse, or Oracle JDeveloper. Our team 
also builds the tools and frameworks 
that are used by developers working with 
Oracle's cloud and mobile platforms. 
Java Magazine: March 2014 saw the 
release of JDK 8 and with it, NetBeans 
IDE 8. How do you view this release? 
Tonas: The release of JDK 8 and 
NetBeans IDE 8 represents a big step 
forward for both Oracle and the Java 
community. A lot of hard work and 
collaboration went into this milestone, 
and I'd like to take a moment to thank 
everyone who contributed to this 
achievement. 

Java Magazine: With the new NetBeans 
IDE 8.0 out, what are the plans for 
NetBeans going forward? 

Tonas: In the short term, an update 
release of NetBeans IDE 8 is under 
way to align with Java ME 8. Additional 
NetBeans 8 releases that target specific 
bugs are anticipated to be released after 
that. Longer term, Oracle is commit¬ 
ted to the continued success of both 
Java and NetBeans. Work on JDK 9 is 
now under way and we're planning a 
NetBeans 9 release to go along with 
that, as usual. 

Java Magazine: As you mentioned, 
Oracle supports more than just 
NetBeans IDE. What's the thinking 
behind that? 


Tonas: Oracle recognizes that developer 
tools aren't a one-size-fits-all proposi¬ 
tion. Oracle is a significant contribu¬ 
tor to the Eclipse project, and we are 
continuing to extend the capabilities 
of our Eclipse-based solutions as well. 
We offer Oracle JDeveloper for those 
who want the tightest alignment with 
the Oracle Fusion Middleware stack. 

In addition, we recognize that many 
JavaScript developers want to use light¬ 
weight tools, and we are planning to 
address those needs as well. 

Java Magazine: What are some of the 
key trends you see in the software 
development space right now? 

Tonas: It's clear that several significant 
trends are shaping software develop¬ 
ment and tools. Oracle is at the fore¬ 
front of these changes and a leader in 
almost every aspect. We see three main 
changes happening right now. 

First, Java remains the industry stan¬ 
dard for server-side development, but 
we see growing demand to support 
developers using the combination of 
JavaScript and HTML5forthe presenta¬ 
tion layer. We see JavaScript starting to 
gain ground for some server-side use 
cases as well. 

Second, the shift to cloud-based 
deployment is now mainstream. 
Development for the cloud presents a 
new set of challenges and demands a 
fresh approach. 

The third shift is the move to 
mobile. Mobile development must 
be integrated across the enterprise 
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IDEs at a Glance 

Eclipse 

From: Eclipse Foundation 
Price: Free 

Latest release: Eclipse Kepler 
(4.3.2) 

License: Eclipse Public License 
The Eclipse ecosystem is rich with 
projects and plugins. Java developers 
can choose from several packages, 
including Eclipse Standard, Eclipse 
IDE for Java Developers, Eclipse IDE 
for Java EE Developers, and more. 
These packages include tools for 
Java developers creating Java EE 
and web applications, including a 
Java IDE, tools for Java EE, Java 
Persistence API (JPA), JavaServer 
Faces (JSF), Mylyn, EGit, and others. 

IntelliJ 

From: JetBrains 
Price: Community Edition—free; 
Ultimate Edition—US$500 
(application server and frameworks 
support, database support, addi¬ 
tional languages) 

Latest release: IntelliJ IDEA 13 
License: Commercial 
IntelliJ IDEA provides a compre¬ 
hensive feature set including tools 
and integrations with the most- 
important modern technologies 
and frameworks for enterprise and 
web development with Java, Scala, 
Groovy, and other languages. 


NetBeans 

From: Oracle 
Price: Free 

Latest release: NetBeans IDE 8.0 
License: A dual license consisting 
of the Common Development and 
Distribution License (CDDL) vl.O 

and the GNU General Public 

License (GPL) v2. 

Ready to go out of the box, 
NetBeans IDE provides code analy¬ 
zers and editors for working with 
the latest Java technologies. 
NetBeans IDE supports many lan¬ 
guages, including PHP, JavaScript, 
HTML5, Groovy, and C++. 

Oracle JDeveloper 

From: Oracle 
Price: Free 

Latest release: Oracle 
JDeveloper 12c 

License: OTN JDevejoper License 
Agreement 

Oracle JDeveloper is the develop¬ 
ment environment for Oracle Fusion 
Middleware with specific extensions 
that cover Oracle SOA Suite, Oracle 
WebCenter Portal, and Oracle 
Business Intelligence llg. It inte¬ 
grates a full database development 
environment for both Oracle and 
non-Oracle databases and offers 
a complete solution for developers 
looking to increase their productiv¬ 
ity building SOA-enabled enterprise 
Java applications. 
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Pari Tajiki, director of development at Oracle, catches up with Tonas about 
product release schedules. 


from the design phase throughout 
the lifecycle. 

These changes require an evolu¬ 
tion of the tooling and infrastruc¬ 
ture that are used to design and 
develop applications. 

Java Magazine: What is 
Oracle doing to address these 
requirements? 

Tonas: Some of the work has 
already happened. For example, 
NetBeans has supported the Java 


and JavaScript combination for 
a few releases now. Looking for¬ 
ward, Oracle has several new and 
innovative browser-based, cloud¬ 
centric, and mobile initiatives 
under way that we will be sharing 
with the community over the next 
several months. 

We are leveraging skills and 
technology from across our cur¬ 
rent developer tools organization 
to develop these new capabilities. 











































Brian Fry, director of 
product management, 
chats with Tonas about 
Oracle’s cloud tooling 
strategy. 


We see the new generation of developer 
tools as complementary to the tools 
that developers use and love today. 

The first of these initiatives that you'll 
be able to use will be the forthcoming 
Oracle Developer Cloud Service—bring¬ 
ing your ALM [asset lifecycle manage¬ 
ment] and team collaboration work to 
the cloud. [You can read more about it.] 
Java Magazine: You mentioned that 
enterprises are focusing on mobile 
development. Does]ava fit into mobile 
development, and what is Oracle's solu¬ 
tion there? 


Tonas: ]ava is key to mobile 
development at Oracle, 
both for on-device apps 
and mobile middleware. 
Oracle Mobile Platform is 
designed to be modular so 
you can use individual com¬ 
ponents or the entire plat¬ 
form. We're in the process 
of expanding our mobile 
platform, but it's already an 
impressive offering. 

We're focusing on mak¬ 
ing ]ava developers suc¬ 
cessful in mobile develop¬ 
ment with Oracle Mobile 
Application Framework. 
Developers can write code 
in ]ava and run it on iOS 
or Android tablets and 
phones. Developers can 
also write JavaScript/ 
HTML5 or a combination of 
Java and JavaScript/HTML5 and deploy 
it in the same manner. 

Oracle Mobile Suite contains every¬ 
thing an enterprise needs to mobilize 
its on-premises and cloud-deployed 
applications, and all components are 
based on Java. Integration to these 
systems is exposed as REST APIs for 
easy consumption in the mobile appli¬ 
cation framework. 

Oracle Mobile Security Suite ensures 
that enterprises can safely provide 
access to sensitive enterprise applica¬ 
tions and data on users' own mobile 


devices, and it integrates with exist¬ 
ing identity and access solutions in 
the enterprise. 

Java Magazine: Where can developers 
learn more about these new tools? 
Tonas: Just as every year, Oracle's full 
vision for the future of software devel¬ 
opment will be shared at JavaOne and 
Oracle OpenWorld later this year. Our 
team is looking forward to sharing what 
we are working on with the develop¬ 
ment community. </articie> 
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Tools and 
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As Senior Community Manager for 
Java Developers for Oracle Technology 
Network, Tori Wieldt manages the Java 
developer experience across all channels 
of Oracle’s developer program: OTN/Java, 
@Java , Java Magazine, blogs.oracle 
.com/java, and YouTube/Java. She loves 
to travel and to interview developers 
around the world. She has been involved 
in technology as a tech writer, sys admin, 
web manager, and marketeer. 
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Java Image Enabling SDKs that Help You Seethe Big Picture 


At first glance it may seem difficult but it's really quite simple. Atalasoft's 
Joltlmage product is a proven SDK for image enabling your Java-based web 
applications, easily, image enabling helps to add dimension to your data, so 
you can uncover insights such as correlations and causations hidden inside 
your 2-dimensional documents. Our SDK does the heavy lifting for you, 
saving time, money, and the headaches of figuring it out yourself. Backed by 
our highly knowledgeable & caffeinated support engineers, Joltlmage will 
enable your success and make the big picture so much easier to see. 
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Click for tips on viewing the stereogram 
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Quick and Easy Conversion to 
Java SE 8 with NetBeans IDE 8 


New tools in NetBeans 8 for leveraging the functional features of Java SE 8 


GEERTJAN WIELENGA, 
LYLE FRANKLIN, AND 
ALEXGYORI 


BIO 


I n this article, we're going 
to look at new and helpful 
tools in NetBeans IDE 8 that 
enable developers to use the 
functional features of java 
SE 8. java SE 8 introduces 
lambda expressions to the 
language. Figure 1 shows a 
lambda expression in java. 
The parameters are shown 
on the left side of the lambda 
arrow, while the method body 
is shown to its right. 


NetBeans IDE 8 provides 
two automated refactor¬ 
ings that leverage this new 
language feature. The first 
refactoring converts anony¬ 
mous inner classes to lambda 
expressions, and the second 
refactoring converts for loops 
that iterate over collections to 
functional operations that use 
lambda expressions. 

We'll start by looking at the 
first refactoring. Anonymous 


Development 
Tools and 
Techniques 


Building Blocks of Java 8 
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Geertjan Wielenga shows you how to 
migrate your code to Java SE 8. 



inner classes such as the one 
shown in Figure 2 are useful 
constructs, although the syn¬ 
tax is unnecessarily verbose. 
Lambda expressions provide a 
more concise replacement for 
anonymous inner classes that 


declare only a single method. 

NetBeans IDE 8 highlights 
valid refactoring sites (see 
Figure 3), and when you 
select the java hint in the left 
sidebar, the IDE performs the 
conversion automatically. As 


ActionListener listener = (ActionEvent e) -> { 
System. out. printIn ("hello lambda"); }; 


Figure 1 


21 JButton testEutton = new JButtonl Test Buttoi ); 

J testButton.addAc tionLi s tener(new ActionListener() ( 

23 @ Override 

& Q public veld aGttonP«r£o«iiad(Actiorilv*nt ae) { 

25 Sys tea .out. println ( n Cl i ck. Be tected by Anon Class *) ; 

2e } 

21 - }); 


Figure 2 


21 

ft 

23 

© 

25 

26 
2? 


JButton testButton = new JButton( ■ est Button ); 

teatButton-ftddActionListener (new ActionListener[) { 

QWJ5J ^ ffiErawre-v .1 ■! ► 

public void actionPerformed(ActionEvent ae) { 

System, out. print In ("Click Detected by Anon Class' 1 ),' 

1 

n ; 


Figure 3 
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you can see in Figure 4, the new 
syntax is much more concise and 
easier to read. 

While this transformation might 
seem simple at first glance, the IDE 
performs static analysis to ensure 
that the transformation is per¬ 
formed safely. For example, exam¬ 
ine the code snippet in Figure 5. 


In this method, the doPrivileged 
method is overloaded and can 
accept either a Privileged Action or 
a PrivilegedExceptionAction. When 
you perform the refactoring, the 
IDE automatically adds a cast to the 
correct type (see Figure 6). 

If this cast were not added, the 
resulting lambda expression would 


21 


JButton testButton = new JButton( "Test Button"); 

22 


testButton.addActionListener{(ActionEvent ae) -> { 

23 


System. out. printIn ("Click Detected by Anon Class"); 

24 


}); 


Figure 4 


27 


try { 

28 


canv = Ac cess Centro lie r . daPrivileged( 

ft 

- 

1 new PrivLlegedExaeptionAction<B2CConverter>0 { 

30 


@Override 



i] public B2CConverter run() throws Exception { 

32 


return new B2CConverter{enc) ; 

33 


1 

34 


}>; 

35 


) catch (PrivilegedActionException ex) { 

36 


Exception e * ex,getException() ; 

37 


if (e inatanceof lOException) f 

38 


throw (lOException) e; 

39 


* 

40 


1 


Figure 5 


27 


try { 

23 


coznr = AccessControHer. doPrivl 1 eqred( 

29 


(PrivilegedExceptionAction<B2CConverter>) () -> new B2< 

30 


} catch {PrivilegedActionException ex) { 

31 


Exception e = ex.getException(); 

32 


if {e instanceof lOException) { 

33 


throw (lOException) e; 

34 


} 

35 


} 


Figure 6 
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be ambiguous, as shown in Figure 7, 
and a compilation error would 
result. In Figure 8, a variable dec¬ 
laration in the anonymous inner 
class hides or shadows a variable 
declared in the enclosing scope. 

While variable shadowing is 
legal in anonymous inner classes, 
lambda expressions do not allow 
this. The IDE detects variable shad¬ 
owing and automatically renames 
shadowing variables to avoid com¬ 
pilation errors. As you can see in 


Figure 9, a 1 was appended to the 
variable name to avoid any errors. 

The second refactoring, which 
is shown in Figure 10, highlights 
another feature of Java SE 8: inter¬ 
nal iterators. Java SE 8 has added 
several methods to the Collections 
API that take a lambda expression 
as an argument and enable func¬ 
tional operations over collections. 
Some examples of these operations 
are MapReduce, filterForEach, and 
anyMatch, to name a few. The IDE 


27 


try { 

Q 


cony = AccessController . doPrlvi 1 ecred ( 

29 


() -> new B2CConverter (enc) ); 

30 


} catch (PrivilegedActionException ex) { 

31 


Exception e = ex.getException(); 

32 


if (e instanceof lOException) { 

33 


throw (lOException) e; 

34 


} 

35 


} 


Figure 7 


19 


II private JSlider createZooinSlider (3 { 

20 


JSlider slider = new JSlider () ; 

21 


slider. setFocusable (true) ; 

22 


slider. setMinizrmm (1) ; 

23 


s 1 ider. s e tMaximum. (800) ; 

24 


slider . setValue (10G) ; 

ft 

. 

J slider. addChange Listener {new ChangeLis tenet () ( 

26 


(^Override 

m 

E 

] public void stateChanged(ChangeEvent event) ( 

28 


JSlider slider = (JSlider)event,getSource(}; 

29 



30 


} 

31 


}) ; 

32 


return slider; 

33 


- } 


Figure 8 
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can refactor existing external itera¬ 
tors, such as enhanced for loops, to 
utilize these new internal iterators. 

In the example in Figure 11, 
the total number of errors in a 
collection of rules is calculated. 
Although it might not be obvi¬ 
ous, this example is analogous to 
a filter MapReduce operation. The 
if statement filters out elements, 
the function call maps a rule to the 


number of errors, and the com¬ 
pound assignment adds each count 
to an accumulator. The IDE can 
automatically refactor this code 
to use functional operations, as 
shown in Figure 12. 

This example also shows that 
the types of the parameters of the 
lambda expressions can be omit¬ 
ted and can instead be inferred by 
the compiler. However, you might 


19 

E 

3 private JSlider createZoomSlider () { 

20 


JSlider slider = new JSlider {); 

21 


slider.setFocusable (true) ; 

22 


slider.setMinimum(1); 

23 


slider. setMaximum (800) ; 

2 4 


slider.setValue(100) ; 

25 


slider . addChangeListener ( (ChangeEvent event) -> { 

26 


JSlider sliderl = (JSlider)event.getSource (); 

27 


}) ; 

23 


return slider; 

29 


L } 


Figure 9 


public int getTotalWeight(List<Rlock> blocks) { 
return blocks.stream {) 

.map(b -> b.getWeight{)) 

.reduce(0 r (a r b) -> a + b) ; 

} 

public void changeColor(List<Rlock> blocks) { 
blocks.stream() 

. filter (b -> b.getColor() = Color. RED) 

.forEach(b -> b.setColor{Color. BLUE ) ); 

} 

public boolean areAnyRlocksRlue(List<Rlock> blocks){ 

return blocks.stream() .anyMatch{b -> b.getColor() = Color. BLUE) ; 

} 

Figure 10 
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find it useful for readability or 
style reasons to let the IDE create 
the parameter types for you (see 

Figure 13). 

As you can see in Figure 14, in 


line 10, the parameter type has now 
been set explicitly. 

Conversion to method 
references—the alternative way of 
working with lambda expressions— 


7 

E 

3 public int getNumberOf Errors (String grammar Name) { 

3 


int count =0; 

ft 


for (ElementRule rule : getRules()) { 

10 


if (rule.hasErrors()){ 

11 


count += rule.getErrorCount(); 

12 


} 

13 


} 

14 


return count; 

15 


L } 


Figure 11 


7 

E 

3 public int getNumberOf Errors (String grammarName) { 

3 


int count =0; 

9 


count = getRules().stream(). 

10 


filter((rule) -> (rule.hasErrors())). 

11 


map((rule) -> rule.getErrorCount{)). 

12 


reduce(count r Integer::sum); 

13 


return count; 

14 


L > 


Figure 12 


9 



count = getRules f) - stream (} , 

ft 



filter((rule) -> 

rule . hasErrors {) ) ) . 

11 




i . getErrorCount ( ) 3 ■ 




12 



§ Use anonymous innercbss ► 

;ger: : sum) ; 

13 



9 Use block as the lambda's body * 

14 



1 



Figure 13 


9 


count = getRules().stream(). 

ft 


filter ( (ElementRule rule) -[> (rule .hasErrors ())) . 

11 


map((rule) -> rule.getErrorCount()). 

12 


reduce(count r Integer::sum); 

13 


return count; 

14 


L } 


Figure 14 
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>- 

tz 


9 



map ((rule) rule .getErrorCount [)) . 

12 



y use explicit parameter types ► 

sger: : sum) ; 

13 



9 Use anonymous inn ere lass * 


14 

15 



I* Use member reference i 



9 Use block as the bmbda'5 body ► 



Figure 15 


9 


count = getRules() . stream () . 

10 


filter((rule) -> (rule.hasErrors())) 

11 


map(EiementRule::getErrorCount). 

12 


reduce(count f Integer::sum); 

13 


return count; 


Figure 16 



Figure 17 



Figure 18 
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JButton testButton = new JButton {" Te s t Button ); 
tea tBufc t on . addAc tionLis tener (new ActionListener [} { 
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1 " Deable "Convert to Lambda or Member Reference" Hnt J 

public void actionl 

System. out .prin 

} 

}}; 

9 Configure “Convert to Lambda or Member Reference 1 * Hint 

9 Run Inspect on.,, 

9 Run Inspect&Transform on... 

9 Suppress Warning - Convert2Lsmbda 


Figure 19 
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is also supported by the IDE (see 

Figure 15). As shown in Figure 16, 

the syntax has now replaced 
the -> syntax of standard lambda 
expressions. 

Without the aid of an automated 
tool, these refactorings are time 
consuming and can introduce 
subtle bugs if done incorrectly. 
NetBeans IDE performs these 
refactorings quickly, while preserv¬ 
ing the original program behavior. 

In addition to the quick hint 
mode of operation, the IDE can 


function in batch mode. As shown 
in Figure 17, you can select a single 
file, an entire project, or all open 
projects, and the IDE will generate 
a preview of all possible conver¬ 
sions for that selection. 

Instead of using the batch refac¬ 
toring tool, whenever you see a 
Java hint in the left sidebar you can 
specify that the refactoring should 
be done across a scope of your 
choice (see Figure 18). 

Even projects with hundreds of 
thousands of lines of code can be 


scanned in a matter of seconds. 
The preview allows for fine-grained 
control over which conversion 
should take place, or it can simply 
refactor all possible conversions 
(see Figure 19). 

Conclusion 

NetBeans IDE 8 provides the tools 
you need to smoothly and correctly 
upgrade your imperative code con¬ 
structs to the new functional style 
introduced in Java SE 8. Its auto¬ 
mated refactoring capability can 


refactor your code to use functional 
operations, and its batch mode 
allows you to specify the scope of 
the refactoring. Get started convert¬ 
ing your code today! </article> 

MORE ON TOPIC: 


Development 
Tools and 
Techniques 


A LEARN MORE 

• Download NetBeans IDE 8 



f 




java 

.net 


blog 




ORACLE.COM/JAVAMAGAZINE /////////////////////////////////////////////// MAY/JUNE 2014 



















































































































//java architect / 



Exploring Java 8 Profiles 

What can Compact Profiles do for your application? 


BEN EVANS 


BIO 


PHOTOGRAPH BY 
JOHN BLYTHE 


ava 8 introduces the con¬ 
cept of Compact Profiles, 
which are reduced versions of 
the java runtime environment 
(JRE) that do not contain the 
usual full contents of rt.jar. In 
this article, we will explore the 
advantages of using Compact 
Profiles and how they point 
the way toward a modular 
future for the JDK. 

The current versions of the 
JRE are quite monolithic: rt.jar 
is at least 60 MB on its own, 
without taking into account 
the size of native code loaded 
as dynamic libraries. If we 
can reduce the size of the 
Java platform footprint and 
move to a modular view of 
the JDK, we can realize some 
great benefits: 

■ Faster Java Virtual Machine 
(JVM) startup times 

■ Reduced resource 
consumption 

■ Removal of packages that, 
in hindsight, shouldn't be 
in the core 

■ Improved security, because 


removing unused classes 
reduces the attack surface 
of the platform 

■ Convergence of the Java 
ME Connected Device 
Configuration (CDC) with 
Java SE 

The initial approach to this 
effort was a full modulariza¬ 
tion of the platform, known 
as Project Jigsaw. This ambi¬ 
tious project also included 
other goals: 

■ Incorporate best practices 
for dependencies into the 
platform core, and apply 
lessons learned about 
dependency management 
from tools such as Maven, 
Apache Ivy, OSGi standard, 
and Linux distributions. 

■ Isolate dependencies— 
solve the library versioning 
problem. 

■ Allow application develop¬ 
ers to package their code 
as modules, rather than as 
JAR files. 

The catch is that in order to 
achieve the full set of goals, 


major surgery on the Java 
platform core is required. In 
particular, a new approach 
to classloading—involving 
a "modular classloader"—is 
required. This has a lot of 
edge cases and is a complex 
undertaking, especially if we 
need to maintain backward 
compatibility. 

In order to maintain the 
release date for Java 8, a deci¬ 
sion was made to move full 
modularity out to Java 9, 
targeted for 2016. Java 8 
Compact Profiles are 
designed to be a first step 
toward full modularity, with 
some of the basic advantages 
noted above. They build 
on the initial work done for 
modularity and provide a cut- 
down Java runtime, which 

■ Is fully compliant with the 
JVM and Java language 
specifications 

■ Has a substantially reduced 
footprint 

■ Removes functionality that 
is not always needed (for 


example, CORBA) 

■ Works for many applica¬ 
tions (especially server- 
side code) 

Compact Profiles are based 
on packages; they contain 
a number of full packages, 
and no partial packages are 
currently allowed. They are 
also subject to two other 
restrictions: 

■ A profile must form a 
closed set; references to 
classes not contained in 
the profile are not allowed. 

■ If a profile contains some 
classes from another, 
smaller profile, it must con¬ 
tain all of them, so partially 
overlapping profiles are not 
allowed. Put another way, 
profiles are additive. 

The smallest Compact 
Profile is called compactl, and 
it comprises the following 
packages: java.io, java.lang, 
java.lang.annotation, java.lang 
.invoke, java.lang. ref, java.lang 
.reflect, java.math, java.net, 
java.nio, java.nio.channels, 
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java.nio.channels.spi, java.nio 
.charset, java.nio.charset.spi, java 
.nio.file, java.nio.file.attribute, 
java.m'o.file.spi, java.security, java 
.security.cert, java.security 
.interfaces, java.security.spec, 
java.text, java.text.spi, java.time, 
java.time.chrono, java.time 
.format, java.time.temporal, java 
.time.zone, java.util, java.util 
.concurrent, java.util, concurrent 
.atomic, java.util.concurrent.locks, 
java.util.function, java.util.jar, java 
.util.logging, java.util.regex, java.util 
.spi, java.util.stream, java.util.zip, 
javax.crypto, javax.crypto.interfaces, 
javax.crypto.spec, javax.net, javax 
.net.ssl, javax.script, javax.security 
.auth, javax.security.auth 
.callback, javax.security 
.auth.login, javax.security 
.auth.spi, javax.security 
.auth.x500, and javax 
.security.cert. 

Two other Compact 
Profiles are currently 
specified: compact2, 
which adds packages 
used for remote method 
invocation (RMI), SQL, 
and XML, and compact3, 
which comprises all of 
compact2 plus tooling 
and management pack¬ 
ages (includingjava 
Management Extensions 
[JMX]) as well as addi¬ 
tional cryptography 


libraries. The smallest profile, 
compactl, occupies around 11 MB, 
which is a significant space savings. 

Note that as currently speci¬ 
fied, all of these profiles are head¬ 
less; they do not contain any GUI 
classes. Any applications requiring 
GUI support (Swing or AWT) must 
use a full JRE. 

Tools 

To make use of Compact Profiles, 
developers require tools. One 
important question is whether an 
application can run against a spe¬ 
cific profile. Java 8 ships with two 
tools that have been enhanced to 
help answer this question: both 
javac and jdeps have 
been modified to be 
aware of profiles. 

javac is the tool of 
choice for determin¬ 
ing whether a collection 
of source code can be 
safely run on a specific 
profile. This is achieved 
by using the new -profile 
switch, javac -profile 
<profile> will cause a 
compilation error to be 
generated for any usage 
of a class not present in 
the indicated profile. 

In some cases, how¬ 
ever, source code is not 
available or a recompila¬ 
tion run is inconvenient. 



GET SMALLER 


Java 8 
introduces 
the concept 
of Compact 
Profiles, which 
are reduced 
versions of the 
Java runtime 
environment (JRE) 
that do not contain 
the usual full 
contents of rt.jar. 
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LISTING 2 / LISTING 3 


jdeps -s -P junit.jar 


junit.jar 


-> compactl 


>- 


o 

o 


o 

< 


I 
~) 


^3 Download all listings in this issue as text 


Fortunately, in this case, the new 
jdeps tool can help. 

jdeps is a new static analysis tool 
that ships with Java 8. It provides 
an analysis of the dependencies 
that a specific class or JAR file has. 
This tool is extremely useful (and 
not just for profile dependencies) 
and features a -profile (or -P) switch 
that indicates which packages 
depend on which profiles. 

Let's take a look at an example, 
which summarizes the package 
dependencies for the popular JUnit 
testing library. See Listing 1, which 
shows good news; everyone should 
be able to test their code. 


If we want more information, we 
can use the -v switch for verbose 
output, which will give us a lot of 
detail about each class inside the 
JAR file. See Listing 2 (some of the 
output was truncated because it 
was 2,152 lines long). 

If we want a slightly more high- 
level view, we can use -V package to 
show dependencies between pack¬ 
ages, as shown in Listing 3 (some of 
the output was truncated because 
it was 1,297 lines long). 

jdeps is also very flexible about 
what it will accept as input: a JAR 
file, a directory, or a single .class file. 
It provides capabilities for recursive 
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traversal and for speci¬ 
fying that only pack¬ 
ages with a name that 
matches a given regular 
expression should be 
considered. It can also 
warn that code uses 
an internal API and is 
not portable between 
Java environments 
(and might break if run 
against a future version of Java). 

Finally, let's look at the NetBeans 
IDE. The current version is 8.0, 
which already has support for 
a wide range of JDK 8 features, 
including Compact Profiles. When 
selecting which JDK or JRE to use 
in Project Properties, for JDK 8 
and later, a developer can choose 
whether to compile against the full 
JRE or a profile. This makes it much 
easier to ensure that when target¬ 
ing a particular profile, unwanted 
dependencies don't creep in. With 
luck, other IDEs will follow suit and 
also add support to allow develop¬ 
ers to write code in the IDE that 
checks conformance with a specific 
profile at development time. 

A Word About Stripped 
Implementations 

In addition to Compact Profiles, 
there is another proposed new 
technique for reducing resource 
utilization for deployed JVM appli¬ 
cations: Stripped Implementations. 


A Stripped Implemen¬ 
tation is a reduced JRE, 
which is packaged with 
an application that has 
the exclusive use of it. 
Because the applica¬ 
tion is the only possible 
client for the Stripped 
Implementation, the run¬ 
time can be aggressively 
pruned, removing pack¬ 
ages, classes, and even methods 
that are not used by the application. 

This approach is advantageous in 
circumstances where resource limi¬ 
tations are severe. It relies on exten¬ 
sive testing to ensure that nothing 
that the application could rely on is 
removed by the stripping process. 

In general, it is extremely difficult 
to get a precise accounting of an 
application's dependencies. This is 
due in large part to the existence 
of techniques such as reflection 
and classloading, which can greatly 
complicate (or even render impossi¬ 
ble) the task of ascertaining the true 
dependencies of a set of classes. 

Compact Profiles are very 
different from Stripped 
Implementations—the former 
are Java runtimes designed for 
general-purpose use and are com¬ 
plete implementations of the Java 
language specification, whereas 
Stripped Implementations are 
defined to be single-use, nonreus- 
able implementations that do not 
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have to conform to the Java lan¬ 
guage specification at their point of 
delivery to the user. 

Stripped Implementations were 
targeted as a feature for Java SE 8, 
but due to some complications 
with licensing and the current 
testing kit, they had to be dropped 
very close to the release date. 
Nevertheless, the intention is for 
Stripped Implementations to 
become part of the platform 
shortly after the release of Java 8, 
and when combined with Compact 
Profiles, they have the potential to 
provide extremely small footprints 
for single-use applications. 

Conclusion 

Java 8 Compact Profiles represent 
a significant step toward future 
goals for the platform—both in 
terms of embedded (or capability- 
restricted) development and also 
for server-side developers. While 
not being the complete modular¬ 
ity solution we might have wished 
for in Java 8, Compact Profiles are 
a useful development in their own 
right. </article> 
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Processing Data with 
Java SE 8 Streams 


RAOUL-GABRIEL URMA Combine advanced operations of the Stream API to express rich data processing queries. 
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n the first part of this series, 
you saw that streams let 
you process collections with 
database-like operations. As 
a refresher, the example in 
Listing 1 shows how to sum 
the values of only expensive 
transactions using the Stream 
API. We set up a pipeline of 
operations consisting of inter¬ 
mediate operations (filter, 
map) and a terminal opera¬ 
tion (reduce), as illustrated in 
Figure 1. 

However, the first part of 
this series didn't investigate 
two operations: 

■ flatMap: An intermediate 
operation that lets you 


combine a "map" and a 
"flatten" operation 
■ collect: A terminal operation 
that takes as an argument 
various recipes (called 
collectors) for accumulating 
the elements of a stream 
into a summary result 
These two operations 
are useful for expressing 
more-complex queries. For 
instance, you can combine 
flatMap and collect to produce 
a Map representing the num¬ 
ber of occu rrences of each 
character that appears in a 
stream of words, as shown 
in Listing 2. Don't worry if 
this code seems overwhelm¬ 


ing at first. The purpose of 
this article is to explain and 
explore these two operations 
in more detail. 

The code in Listing 2 will 
produce the output shown in 
Listing 3. Awesome, isn't it? 
Let's get started and explore 
how the flatMap and collect 
operations work. 

flatMap Operation 

Suppose you would like to 
find all unique words in a file. 
How would you go about it? 

You might think that it is 
easy; we can use Files.Iines(), 
which you saw in the previous 
article, because it can return a 
stream consisting of the lines 
of a file. We can then split 
each line into words using a 
map() operation and, finally, 
use the operation distinct() 
to remove duplicates. A first 
attempt could be the code 
shown in Listing4. 


Unfortunately, this is not 
quite right. If you run this 
code, you will get puzzling 
output similar to this: 

I [Ljava.lang.String;@7cca494b 
[Ljava.lang.String;@7ba4f24f 

Our first attempt is actu¬ 
ally printing the String repre¬ 
sentation of several streams! 
What is happening? The 
problem with this approach 
is that the lambda passed 
to the map method returns 
an array of String (String[]) 
for each line in the file. As a 
result, the stream returned 
by the map method is actu¬ 
ally of type Stream<String[]>. 
What we really want is 
Stream<String> to represent 
a stream of words. 

Luckily there's a solution 
to this problem using the 
method flatMap. Let's see 
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STREAM of 
WORDS 


Magazine 


Steam<String> 



List<String> 


Figure 2 


step-by-step how to get to the 
right solution. 

First, we need a stream of words 
instead of a stream of arrays. 
There's a method called Arrays 
.stream() that takes an array and 
produces a stream. See the exam¬ 
ple shown in Listing 5. 

Let's use it in our previous stream 
pipeline to see what happens 
(see Listing 6). The solution still 
doesn't work. This is because we 
now end up with a list of streams 
of streams (more precisely a 
Stream<Stream<String»). Indeed, 
we first convert each line into an 
array of words, and then convert 
each array into a separate stream 


using the method Arrays.stream(). 

We can fix this problem by using 
a flatMap, as shown in Listing 7. 
Using the flatMap method has the 
effect of replacing each generated 
array not by a stream but by the 
contents of that stream. In other 
words, all the separate streams 
that were generated when using 
map(Arrays::stream) get amalgam¬ 
ated or "flattened" into one single 
stream. Figure 2 illustrates the 
effect of using the flatMap method. 

In a nutshell, flatMap lets you 
replace each value of a stream with 
another stream, and then it con¬ 
catenates all the generated streams 
into one single stream. 
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int sumExpensive = 
transactions.streamQ 

.filter(t -> t.getValue() > 1000) 
.map(Transaction::getValue) 
.reduce(0, Integer-sum); 
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Note that flatMap is a com¬ 
mon pattern. You will see it again 
when dealing with Optional or 
CompletableFuture. 

collect Operation 

Let's now look at the collect 
method in more detail. The opera¬ 
tions you saw in the first part of 
this series were either returning 
another stream (that is, they were 
intermediate operations) or return¬ 
ing a value, such as a boolean, an 
int, or an Optional object (that is, 
they were terminal operations). 

The collect method is a terminal 
operation, but it is a bit different 
because you used it to transform 
a stream into a list. For example, 
to get a list of the IDs for all the 
expensive transactions, you can use 
the code shown in Listing 8. 

The argument passed to 
collect is an object of type java 


.util.stream.Collector. What does a 
Collector object do? It essentially 
describes a recipe for accumulat¬ 
ing the elements of a stream into 
a final result. The factory method 
Collectors.toList() used earlier 
returns a Collector describing how 
to accumulate a stream into a list. 
However, there are many similar 
built-in Collectors available. 
Collecting a stream into other col¬ 
lections. For example, using toSet() 
you can convert a stream into a Set, 
which will remove duplicate ele¬ 
ments. The code in Listing 9 shows 
how to generate the set of only the 
cities that have expensive transac¬ 
tions. (Note: In all future examples, 
we assume that the factory meth¬ 
ods of the Collectors class are stati¬ 
cally imported using import static 
java.util, stream. Collectors.*.) 

Note that there are no guarantees 
about what type of Set is returned. 
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However, using toCollectionQ you 
can have more control. For exam¬ 
ple, you can ask for a HashSet by 
passing a constructor reference to it 
(see Listing 10). 

However, that's not all you can 
do with collect and collectors. It is 
actually a very tiny part of what you 
can do. Here are some examples of 
what you can express: 

■ Grouping a list of transactions by 
currency to the sum of the values 
of all transactions with that cur¬ 
rency (returning a Map<Currency, 
Integer>) 

■ Partitioning a list of transac¬ 
tions into two groups: expensive 
and not expensive (returning a 
Map<Boolean, List<Transaction») 

■ Creating multilevel groupings, 
such as grouping 
transactions by cities 
and then further cat¬ 
egorizing by whether 
they are expen¬ 
sive or not (return¬ 
ing a Map<String, 

Map<Boolean, 

List<Transaction»>) 

Excited? Great. Let's 

see how you can express 
these queries using the 
Stream API and collec¬ 
tors. We first start with 
a simple example that 
"summarizes" a stream: 
calculating the average, 
the maximum, and the 


Comparator Comparator 

I I 



Collector Collector 


Figure 3 

minimum of a stream. We then 
look at how to express simple 
groupings, and finally we see how 
to combine collectors together to 
create powerful queries, such as 
multilevel groupings. 

Summarizing. Let's warm up with 
some simple examples. You saw in 
the previous article how 
to calculate the number 
of elements, the maxi¬ 
mum, the minimum, and 
the average of a stream 
using the reduce opera¬ 
tion and using primitive 
streams. There are pre¬ 
defined collectors that let 
you do just that as well. 
For example, you can 
use countingO to count 
the number of items, as 
shown in Listing 11 
You can use summing 
DoubleO, summinglntO, 
and summingLongO 
to sum the values of a 


QUERY POWER 


Using the 
Stream API 
and collectors, 

you can combine 
collectors 
togetherto 
create powerful 
queries, such 
as multilevel 
groupings. 
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I 


Files.lines(Paths.get("stuff.txt")) 

.map(line -> line.split("\\s+")) // Stream<String[]> 
.flatMap(Arrays::stream) // Stream<String> 
.distinct() // Stream<String> 
.forEach(System.out::println); 
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Double, an Int, ora Long property 
of the elements in a stream. In 
Listing 12, we calculate the total 
value of all transactions. 

Similarly, you can use averaging 
DoubleO, averaginglnt(), and 
averagingLongO to calculate the 
average, as shown in Listing 13. 

In addition, by using maxByO and 
minBy() you can calculate the maxi¬ 
mum and minimum element of a 
stream. However, there's a catch: 
you need to define an order for the 
elements of a stream to be able to 
compare them. This is why maxBy 
and minBy take a Comparator object 
as an argument, as illustrated in 
Figure 3. 

In the example in Listing 14, we 
use the static method comparingO, 
which generates a Comparator 
object from a function passed as an 
argument. The function is used to 
extract a comparable key from the 
element of a stream. In this case, 
we find the highest transaction by 
using the value of a transaction as a 
comparison key. 


There's also a reducingO collector 
that lets you combine all elements 
in a stream by repetitively apply¬ 
ing an operation until a result is 
produced. It is conceptually similar 
to the reduce() method you saw 
previously. For example, Listing 15 
shows an alternative way to cal¬ 
culate the sum of all transactions 
using reducing!). 

reducingO takes three arguments: 

■ An initial value (it is returned 
if the stream is empty); in this 
case, it is 0. 

■ A function to apply to each ele¬ 
ment of a stream; in this case, 
we extract the value of each 
transaction. 

■ An operation to combine two 
values produced by the extract¬ 
ing function; in this case, we just 
add up the values. 

You might say, "Wait a minute; 

I can already do that with other 
stream methods, such as reduce!), 
max(), and min(), so why are you 
showing me this?" You will see later 
that we can combine collectors to 
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Classification function 


transactions- 


Transaction::getCurrency 



Grouping Map 


Figure 4 


build more-complex queries (for 
example, grouping plus averaging), 
so it is handy to know about these 
built-in collectors as well. 

Grouping. A common database 
query is to group data using a prop¬ 
erty. For example, you might want 
to group a list of transactions by 
currency. Expressing such a query 
using explicit iteration is somewhat 
painful, as you can see in the code 
in Listing 16. 

You need to first create a Map 
where the transactions will be 
accumulated. Then you need to 
iterate the list of transactions and 
extract the currency for each trans¬ 
action. Before adding the transac¬ 
tion in as a value in the Map, you 
need to check whether a list has 
been created, and so on. It is a 


shame, because fundamentally 
all we want to do is "group the 
transactions by currency." Why 
does it have to involve so much 
code? Good news: there's a collec¬ 
tor called groupingByO that lets us 
express such use cases in a con¬ 
cise way. We can express the same 
query as shown in Listing 17, and 
now the code reads closer to the 
problem statement. 

The groupingByO factory method 
takes as an argument a func¬ 
tion for extracting the key used 
to classify the transactions. We 
call it a classification function. In 
this case, we pass a method refer¬ 
ence, Transaction-getCurrency, to 
group the transaction by currency. 
Figure 4 illustrates the grouping 
operation. 
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double average = transactions.stream().collect( 
averagingInt(Transaction::getValue)); 


£3 Download all listings in this issue as text 


>- 


o 

o 


o 

< 


I 
~) 


Partitioning. There's another fac¬ 
tory method called partitioningByO 
that can be viewed as a special 
case of groupingByO. It takes a 
predicate as an argument (that is, 
a function that returns a boolean) 
and groups the elements of a 
stream according to whether or 
not they match that predicate. In 
other words, partitioning a stream 
of transactions organizes the 
transactions into a Map<Boolean, 
List<Transaction». For example, 
if you want to group the transac¬ 
tions into two lists—cheap and 
expensive—you could use the 
partitioningBy collector as shown in 
Listing 18, where the lambda t -> 
t.getValue() > 1000 is a predicate 
for classifying cheap and expen¬ 
sive transactions. 


Composing collectors. If you are 

familiar with SQL, you might know 
that you can combine GROUP BY 
with functions such as COUNTQ 
and SUMQ to group transactions 
by currency and by their sum. So, 
can we do something similar with 
the Stream API? Yes. Actually, 
there's an overloaded version of 
groupingByO that takes another 
collector object as a second 
argument. This additional collec¬ 
tor is used to define how to accu¬ 
mulate all the elements that were 
associated with a key using the 
groupingBy collector. 

OK, this sounds a bit abstract, 
so let's look at a simple example. 
We would like to generate a Map 
of cities according to the sum of 
all transactions for each city (see 
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Figure 5 


Listing 19). Here, we tell groupingBy 
to use the method getCityO as a 
classification function. As a result, 
the keys of the resulting Map will be 
cities. We would normally expect a 
List<Transaction> back as the value 
for each key of the Map using the 
basic groupingBy. 

However, we are passing an 
additional collector, summinglnt(), 
which sums all the values of the 
transactions associated with a city. 
As a result, we get a Map<String, 
Integer> that maps each city with 
the total value of all transactions for 
that city. Cool, isn't it? Think about 
it: the basic version of groupingBy 
(Transaction::getCity) is actually just 


shorthand for writing groupingBy 
(Transaction-getCity, toList()). 

Let's look at another example. 
How about if you want to gener¬ 
ate a Map of the highest-valued 
transaction for each city? You might 
have guessed that we can reuse the 
maxBy collector we defined earlier, 
as shown in Listing 20. 

You can see that the Stream API is 
really expressive; we are now build¬ 
ing some really interesting queries 
that can be written concisely. Can 
you imagine going back to process¬ 
ing a collection iteratively? 

Let's look at a more-complicated 
example to finish. You saw that 
groupingBy can take another collec¬ 
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Map<String, Integer> cityToSum = 

transactions. stream().collect(groupingBy( 
Transaction::getCity, summingInt(Transaction::getValue))); 
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tor object as an argument to accu¬ 
mulate the elements according to 
a further classification. Because 
groupingBy is a collector itself, we 
can create multilevel groupings by 
passing another groupingBy collec¬ 
tor that defines a second criterion 
by which to classify the stream's 
elements. 

In the code in Listing 21, we 
group the transactions by city, and 
then we further group the transac¬ 
tions by the currency of transac¬ 
tions in each city to get the average 
transaction value for that currency. 
Figure 5 illustrates the mechanism. 
Creating your own collector. All the 
collectors we showed so far imple¬ 
ment the interface java.util.stream 
.Collector. This means that you can 
implement your own collectors 
to define "customized" reduction 
operations. However, this subject 
could easily fit into another article, 
so we won't discuss it here. 

Conclusion 

In this article, we've explored two 
advanced operations of the Stream 


API: flatMap and collect. They are 
tools that you can add to your arse¬ 
nal forexpressing rich data pro¬ 
cessing queries. 

In particular, you've seen that 
the collect method can be used 
to express summarizing, group¬ 
ing, and partitioning operations. 

In addition, these operations can 
be combined to build even richer 
queries, such as "produce a two- 
level Map of the average transac¬ 
tion value for each currency in 
each city." 

However, this article didn't 
investigate all the built-in collectors 
that are available. We invite you to 
take a look at the Collectors class 
and try out other collectors, such as 
mapping!), joining!), and collecting 
AndThen(), which you might find 
useful. </article> 
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SASKIA VERMEER- 
OOMS, REGINA TEN 
BUGGENCATE, AND 
LINDAVANDERPAL 



Development 
Tools and 
Techniques 


A Sprint in the Life of a Scrum Master 

Saskia Vermeer-Ooms gives a tour of a Scrum sprint. 


M ost of us have heard of 
Scrum by now, but not 
all of us have had a chance 
to use it yet. And even if you 
have read boohs or tahen a 
course, it might be difficult to 
decide where to start or how 
to apply Scrum within your 
own organization. 

"That won't work in our 
organization" is a phrase you 
hear often, usually followed 
by other good reasons why 
(part of) Scrum will not work. 
Why not see what someone 
who has been doing Scrum 
for a while—someone who 
has managed to make Scrum 
work with a Scrum product 
owner and operations team 
who live and work in a differ¬ 
ent country than the rest of 
the team—has to say? 

For those of us who haven't 
yet heard, Scrum is an itera¬ 
tive and incremental agile 
software development frame¬ 
work for managing software 
projects and product or appli¬ 
cation development. According 


to Wikipedia, it defines "a flex¬ 
ible, holistic product develop¬ 
ment strategy where a devel¬ 
opment team works as a unit 
to reach a common goal." 

Regina ten Buggencate and 
Linda van der Pal sat down 
with Saskia Vermeer-Ooms to 
find out what really goes on in 
a Scrum development team, 
ten Buggencate: Hi, Saskia. I 
heard you're a Scrum Master 
now. Can you tell us a little bit 
about what that's like? How 
about starting by telling us 
about your team? 
Vermeer-Ooms: I am the 
Scrum Master of a develop¬ 
ment team that consists of 
three Java developers, one 
front-end developer, and one 
team member responsible 
for making web forms. We 
work for a UK-based client, 
and my office is based in the 
Netherlands. We work with 
a technology partner who is 
also based in the UK. This 
tech partner also does devel¬ 
opment on the same plat¬ 


form but, more importantly, 
is also responsible for the 
operations side of the plat¬ 
form. Any deployments to 
the live environment must go 
through this tech partner. 

You can imagine that a lot 
of my time is spent e-mailing, 
on "chat," or in remote 
meetings. My main focus, 
however, is to facilitate my 
team reaching the goals we 
set for each sprint, which 
is three to four weeks long. 
We decided not to go for a 
fixed-length sprint, because 
most of the time a chunk of 
work is too large to fit within 
three weeks, but sometimes 
a four-week sprint is too 


long. So, instead we opted to 
decide on the sprint length 
when we plan the work for 
each sprint. 

van der Pal: So what does 
a regular sprint look like? I 
heard it starts with a sprint 
planning, right? 
Vermeer-Ooms: Sprint plan¬ 
ning sessions are usually 
done on the first Monday of 
the sprint in a meeting room 
where we have a big white¬ 
board that is the same size 
as the Scrum board we have 
in our workspace. This white¬ 
board has plenty of different- 
colored Post-it notes and a 
screen that we project the 
JIRA issues on. 




Figure 1 



o 

o 


o 

< 


I 





CO 


I— 

ZD 

o 

CD 

< 



f 




java 

.net 


blog 




ORACLE.COM/JAVAMAGAZINE /////////////////////////////////////////////// MAY/JUNE 2014 


















































//process / 

Before we go into the sprint plan¬ 
ning session, I make sure that the 
product backlog is up to date. All 
issues that were not completed dur¬ 
ing the previous sprint are moved to 
the new sprint's fix version in JIRA. 
Other issues that have been priori¬ 
tized by the product owner will have 
already been labeled underthis 
sprint's fix version. Team members 
can also label for this fix version 
other issues they deem necessary. 

I also make sure I have an over¬ 
view of all the available hours for 
all team members. Most of my 
team members also work on other 
projects, so I use a spreadsheet 
for keeping track of the available 
hours per week for team members. 

I know doing time-based estima¬ 
tion isn't "Scrum by the books," 
but because of the pressure on our 
team members from other proj¬ 
ects, it is a sad necessity. 

At the beginning of the plan¬ 
ning session, we put the available 
hours per person on one side of the 
whiteboard. On the other side, we 
put on the Post-it notes any JIRA 
issues that were left over from the 
previous sprint and any issues we 
have just added to the backlog. 

Then we go through the issues 
and discuss briefly what each issue 
is about. If the description is not 
clear enough for everyone to be 
able to decide what is required, it is 
rephrased or sometimes the issue 


>- 




Figure 3 


is split into subtasks or multiple 
new issues (see Figure 1). The main 
goal of this part of the planning 
session is to agree on what is being 
asked of us for each issue and to 
ensure that the description of what 
needs to be done is clear. If an issue 
is not yet on the board, we make a 
new Post-it note for it. 

We have three different colors 
of Post-it notes (see Figure 2) that 
correspond to the three different 
priorities: pink for critical, orange 
for major, and green for minor. 

Each note contains the JIRA issue 
(see Figure 3), a short descrip¬ 
tive title, and the first initial of the 
team member to whom the issue 
is assigned. 

In the second half of the plan¬ 
ning session, we put the issues 
on the board by priority (highest 
priority on top). Then each mem¬ 
ber writes time estimates on their 


assigned Post-it notes. These esti¬ 
mates need to be agreed upon by 
the entire team. Everyone has their 
specialty in the team, but if we 
need to have a longer discussion 
about time estimates, we do. We 
use units of a day, with half a day 
being the minimum. 

When we are done with this, each 
member adds up the hours for their 
own issues and writes the total 
next to the hours of availability that 
were put on the board at the start 
of the meeting. We usually end up 
with more hours than are available, 
which means we need to recon¬ 
sider priority. Any issues that don't 
fit get moved to the backlog. When 
we all agree that the issues that are 
left on the board are feasible, we 
are done with the planning. 
ten Buggencate: So you're saying 
that everybody estimates their own 
issues, but I thought that in Scrum, 


there was only one role for this kind 
of work: the Developer role. 
Vermeer-Ooms: That's true, but 
our team members have other 
projects, too, and they all have their 
own specialties. So this is again 
a point where we deviate from 
the default laid out by the Scrum 
method, because this approach 
works better for us. 

To finish our sprint planning, at 
the end of the meeting, I ask each 
team member to grab their own 
Post-it notes and take them to the 
Scrum whiteboard in our work¬ 
space, which we use for our daily 
standup meetings. I also make sure 
that JIRA is updated; the issues that 
are left on the board need to be 
taken out of this sprint version, and 
I can fill in the time estimates we 
just agreed on. 

Now that the JIRA issues are clear 
for this sprint, I can create the draft 


o 

o 


o 

< 


I 


~) 





f 




java 

.net 


blog 



55 


ORACLE.COM/JAVAMAGAZINE /////////////////////////////////////////////// MAY/JUNE 2014 



















































//process / 


release notes. In these notes, I list 
all the issues for this sprint and also 
the dates that are important dur¬ 
ing this sprint. Because we have 
a distributed development and 
operations team, it is important 
to have these dates agreed on at 
the beginning of the sprint. We 
are dependent on our technology 
partner for deployment of our code 
to the UAT [User Acceptance Test] 
environment and the live environ¬ 
ment. We have to plan precisely 
when we need to have our code 
changes ready in order to make the 
proposed live deployment date. 

This is also the time to ask our 
tech partner what the current QA 
Git branch is. Our tech partner also 
does development on the 
same platform; there¬ 
fore, it is essential that 
we get integration issues 
out of the way as soon as 
possible. In other words, 
it is essential to agree on 
the current QA branch 
so that we both have the 
same starting point. 
van der Pal: Wow, that's 
quite a lot of work 
already. So what happens 
next? 

Vermeer-Ooms: What 
follows are the normal 
days of work in progress. 

The day starts with the 
daily standup meeting 


in front of the Scrum whiteboard. 
Each team member informs the 
team what they were working on 
yesterday, what they will be work¬ 
ing on today, and whether any¬ 
thing is blocking them from mak¬ 
ing progress. 

As shown in Figure 4, we update 
the board during these standup 
meetings; Post-it notes are moved 
from the "To do" column, through 
the "In progress" and "To test" 
columns, to the "Done" column. 
During the daily standup meeting, 
we adjust any estimates that turn 
out to be incorrect, and we give an 
indication of what still needs to be 
done for each issue in progress. 

After the standup meeting, 

the team gets back to 
work, and I do my best 
to resolve any impedi¬ 
ments that were men¬ 
tioned in the meeting. 
ten Buggencate: So, do 
you have any tools to 
help you with quality 
assurance? You men¬ 
tioned you were work¬ 
ing with teams in other 
locations. 

Vermeer-Ooms: We 

have a Jenkins job run¬ 
ning a nightly build on 
any code committed to 
the current development 
branch. It also does an 
automatic deployment 


know doing 
time-based 
estimation 
isn’t “Scrum by 
the books,” but 
because ofthe 
pressure on our 
team members 
from other 


pro 

sac 


ects, it is a 
necessity. 
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Figure 4 


of our artifacts to the internal test 
server. This is very helpful for veri¬ 
fying that ongoing development is 
not causing other parts of the sys¬ 
tem to fail. We use this internal test 
serverto verify work in progress 
and to check functionality. 

Unfortunately, we do not have 
a dedicated tester on our team, 
which means that we depend on 
the testing capabilities of all the 
members of the team. That might 
be right according to the books, but 
my experience is that developers 
don't have the same mindset that 
a tester has. We try to make up for 
this by organizing explicit internal 
test sessions where the whole team 
tests a finished feature. We encour¬ 
age each other to plan internal 
test sessions as much as possible. 


These internal test sessions are 
extremely valuable. 

Before we start a session, we 
list the JIRA issues that need to be 
verified. We set up a shared Google 
doc, start testing, and write up all 
our findings. After the test session 
is over, I go through the findings 
and—with the help of the rest of 
my team—add new issues or move 
the issues that had made it "To 
test" but were not resolved back to 
"In progress." The issues that were 
verified to be resolved on our test 
server are labeled "Passed QA." 
van der Pal: So, now that you have 
some work that is tested, do you 
also have the customer test it? 
Vermeer-Ooms: Yes; by Friday, we 
usually have some functionality 
ready to show the product owner. 
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Therefore, I need to verify with him 
that the new functionality we are 
implementing during this sprint is 
doing what is expected. We write 
up a short scenario of how we are 
going to use this new functionality 
and add a list of questions to get 
any uncertainties out of the way. 
After the product owner sends us 
his answers, we can carry on with 
the implementation. 
ten Buggencate: You have three- 
to-four-week sprints. When do you 
stop building new code, and how 
do you hand overyourcodetothe 
people who have to deploy it to 
production? 

Vermeer-Ooms: The release date 
is determined by our client and 
tech partner; it is usually set on a 
Thursday. Therefore, I plan one 
whole week for the deployment 
cycle by the tech partner and set 
the Thursday before the release as 
the code cutoff for our internal inte¬ 
gration environment. 

This Thursday is the day that we 
want to have all our code changes 
in, so they can be run through our 
integration server, which is a differ¬ 
ent server from our development 
test server. 

This integration server is running 
code that is based on the agreed- 
upon QA branch. Developers can 
commit and push code to the 
development branch until lunch¬ 
time. After that, the development 


QA - 

Figure 5 


code is merged with the QA branch 
and a build is started for deploy¬ 
ment on the integration server. 
Other teams in our office also work 
on the same platform, so all paral¬ 
lel development comes together on 
the QA server at this point. 

Release branches are named 
after Pokemon. I hang a printout of 
the current release branch on our 
bulletin board (see Figure 5). 

We use the Friday before the 
deployment week for testing on 
the integration environment and, 
of course, for fixing any bugs that 
are found. We can also use this day 
to do demos of the newly added 
functionality. These demos are for 
each other and anyone else from 
the company who is interested. 
This is also the day to do a demo 
with the product owner and verify 
that we have implemented the 
functionality correctly. Because the 
product owner is based in the UK, 
we have to do his demos remotely. 
Therefore, sometimes his demo is 
separate from the other demos. 
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As shown in Figure 6, if all goes 
well and we are happy with the 
results, it's time for drinks on Friday 
afternoon. If not, we do drinks 
anyway. Sometimes we also do a 
knowledge transfer session where 
someone shows what they have 
been working on lately. 

After the weekend, we start our 
deployment week. Monday after¬ 
noon is the code cutoff for the 
deployment to the UAT environ¬ 
ment. The team has until 3 p.m. to 
fix any bugs and retest. I recheck 
the release notes at this time to see 
whether all the issues listed have, 
in fact, been covered by this sprint 
and will make the deployment. 

The deployment instructions 
involve a list of artifacts that need 
to be deployed as well as any addi¬ 
tional instructions, forms, or work- 
flow files that need to be uploaded 
to the portal manually. The instruc¬ 
tions also include any manual con¬ 
figuration steps. 

On Tuesday morning, our tech 
partner deploys our code to the 



Figure 6 

UAT environment. When UAT is 
signed off by the product owner, 
the code is deployed to the Clones 
environment (which is a second 
acceptance environment that con¬ 
tains an exact copy of live data 
from the production server) on 
Wednesday. On the Clones envi¬ 
ronment we test to verify that the 
live data will not be affected by our 
changes and to see whether the 
added functionality is doing what it 
should do with the actual data. 
van derPal: So what happens if you 
are testing on the Clones environ¬ 
ment and something doesn't work 
as expected? 

Vermeer-Ooms: When our testing 
finds a major bug, the bug should 
be fixed as soon as possible. We 
then exchange e-mail with the tech 
partner to agree on a new deploy¬ 
ment date as soon as possible. 

After the new deployment is 
done, we retest and repeat the 
process if more fixes are needed. 
Sprints such as this necessitate a 
lot of flexibility from our tech part- 
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ner, and we are lucky that they are 
usually very helpful in getting done 
what we need. 

ten Buggencate: Now that every¬ 
thing is done, do you also have a 
sprint review to see what you can 
do better next time? 
Vermeer-Ooms: Because the 
deployment to the live environ¬ 
ment is on Thursday evening, I 
often plan to have the sprint ret¬ 
rospective meeting on this day. In 
most cases, there is not much left 
to do for the sprint, which means 
it is a good time for us to reflect on 
what went well during the sprint 
and what can be improved for 
future sprints. 

Our retrospective meetings are 
open to others in the company, 
but it is important that my team 
members feel safe enough to speak 
their minds, tell each other their 
concerns and, of course, give each 
other compliments (see Figure 7). 

I ask each member of the team 
to prepare for this meeting by writ¬ 
ing down the good stuff and the 
bad stuff they encountered during 




this sprint. Before the meeting, I 
prepare a shared Google doc where 
they can write these points under 
their name. I also list the actions 
that came out of the previous ret¬ 
rospective meeting, so they can see 
which actions have and have not 
been accomplished. We start the 
meeting with a round of bad stuff. 
Everybody is free to speak their 
mind as I take additional notes in 
the shared doc. When everybody 
has had their turn, we go through 
the items again and write down an 
action list in order to improve our 
way of working. 

When everybody feels that their 
points have been heard, we do the 
same thing to discuss the good 
stuff. I make sure all comments are 
written down in the shared doc, 
because these are always nice to 
read later. Sometimes we also do 
a team demo during this meeting 
so everyone keeps up to date with 
the latest additions to the func¬ 
tionality of our product. Sometimes 
team members present what they 
have already been doing for the 
next sprint, or we discuss some of 
the technical discoveries that were 
made during the sprint. At the end 
of the demos, we always applaud. 

If final testing of the Clones envi¬ 
ronment in the afternoon gives us 
the expected results, we give the 
go-ahead for the deployment to 
the live environment that night. 
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After 6 p.m. the hold¬ 
ing pages of the live 
site go up to show end 
users that the platform 
is undergoing mainte¬ 
nance. Deployment is 
done, and then we get 
the signal that we can 
go in to verify that the 
deployment was suc¬ 
cessful. If everything 
went OK, we are happy 
to take down the hold¬ 
ing pages, because the 
sprint made it suc¬ 
cessfully to production. 
van der Pal: But this is 
only Thursday evening; 
what do you do with 
Friday? 

Vermeer-Ooms: Next 
Monday we will be doing sprint 
planning for the next sprint, so 
I use Friday to get everything 
cleaned up and organized again. I 
go through all the JIRA issues that 
were planned for this sprint to 
see whether they have been reas¬ 
signed and set to the correct status 
(resolved). There are always some 
issues that were not completely 
resolved during the sprint, so these 
need to be moved to the next 
sprint so they will be open for dis¬ 
cussion during the upcoming sprint 
planning session. I put the actions 
that came from the retrospective 
meeting on a Post-it note on the 


SAY WHAT YOU THINK 


Our retrospective 
meetings are open 
to others in the 
company, but it is 

important that my 
team members 
feel safe enough to 
speak their minds, 

tell each othertheir 
concerns and, of 
course, give each 
other compliments. 


Scrum board so it is 
clear that they also are 
tasks to be done. 

Sometimes I decide 
that the Scrum board 
needs some cleaning 
up. Any Post-it notes 
still hanging are taken 
down, and I redo the 
lines on the board. I 
like straight lines. 

Friday is also a day 
that team members 
spend on their other 
projects, clean up their 
environments, take on 
the actions from the 
retrospective meet¬ 
ing, or take on a task 
that will improve the 
quality of our code or 
improve our process. If they have 
nothing to do (which has never 
happened), they can help me pre¬ 
pare for the next sprint planning. 
ten Buggencate: Wow—so that's 
what a whole sprint looks like out¬ 
side of a training room. Thank you 
for sharing! </article> 
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Development 
Tools and 
Techniques 


HTML5 and JSF 

Mix and match the two technologies to create sophisticated applications. 



Figure 1 


T his article focuses on inte¬ 
grating HTML5 into new 
and existing Java EE applica¬ 
tions using JavaServer Faces 
(JSF). It covers the basics of 
adding HTML5 components 
into existing JSF views and 
constructing entire JSF views 
using FITML5 markup. 

This article also covers the 
development of server-side 
templates, making it easy 
to change the look and feel 
of different views within 
an application. You will see 
examples demonstrating 
techniques for sending data 
to and from the server via 
FITML5 components using 
WebSocket and JSON-P, 
and you will learn how to 
build these solutions using 
NetBeans IDE. 

The examples in this 
article demonstrate how to 
generate the same web form 
using standard JSF markup, 
HTML5 only, and both JSF 
and FITML5. The examples 
also demonstrate how 


seamlessly FITML5 elements 
can be processed as JSF 
components, and vice versa. 
After reading this article, 
you should have the know¬ 
ledge necessary to begin 
integrating HTML5 compo¬ 
nents and technologies into 
your JSF applications. 

HTML5-Compatible 

Markup 

When developing a web 
application, there are many 
decisions that have to be 
made beforehand. What 
functionality will the appli¬ 
cation provide? What type of 
user will be working with the 
application? Which devices 
will be used to work with the 
application? These are just 
some of the questions that 
must be answered before 
you can choose which tech¬ 
nology or web framework 
to use. 

There are hundreds of 
frameworks and technologies 
that can be used for develop¬ 


ing web applications 
today. JSF is a mature 
and robust specifica¬ 
tion that ranks among 
the leading choices. It 
provides a solid foun¬ 
dation for sophisticated 
server-side applications 
that have the ability to 
maintain state, and it 
allows developers to 
focus on building the 
application, rather than 
spending lots of time 
developing JavaScript 
and CSS. It does so by 
supplying a bevy of 
components that are 
ready to use for build¬ 
ing sophisticated user inter¬ 
faces, abstracting away the 
implementation details of 
each component. 

FITML5 is a new stan¬ 
dard for developing por¬ 
table applications that scale 
across devices seamlessly. 
JSF 2.2 enables interactiv¬ 
ity between FITML5 and JSF 
views, allowing developers to 


take advantage of the seal- 
ability and modernization of 
HTML5, while maintaining 
solid grounds for a robust 
and dependable web appli¬ 
cation. JSF 2.2 lets develop¬ 
ers choose to use JSF com¬ 
ponents, HTML5 elements, 
or both. 

JSF 2.2 introduced new 
namespaces, which can be 
specified for supplying pass¬ 
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through elements, pass-through 
attributes, or both within HTML 
pages. Using these new features, 
HTML5 elements can be treated 
as JSF components, or JSF com¬ 
ponents can pass through to the 
browser without interpretation 
by JSF components or Tenderers. 
HTML5 pages can use JSF back¬ 
ing beans in the same manner as a 
standard JSF view, enabling seam¬ 
less interactivity with JSF. 

A Typical JSF View 

Before we take a look at any 
HTML5, let's look at a standard 
JSF view. The examples used for 
this article are a subset of the 
application for the Java developer's 
paradise, Acme World Resort. In 
this article, we'll focus on a form 
that is used to book a reserva¬ 
tion for a stay at the resort. The 
JSF-only view contains a mixture 
of standard JSF components and 
PrimeFaces components. It is also 
good to note 
that the view 
does not con¬ 
tain validation, 
but it is impor¬ 
tant to add 
validation to any 
web application 
prior to release. 

Listing 1 
contains the 
JSF-only view 


for the reservation form. As you 
can see, the view contains a num¬ 
ber of PrimeFaces components, 
specifically inputText, spinner, and 
calendar, to formulate the reserva¬ 
tion form. Figure 1 shows what the 
JSF-only view looks like. 

HTML5-Only View 

Now that we've seen how to pro¬ 
duce the form using JSF markup 
only, let's shift to HTML5. The form 
in Listings 2a, 2b, and 2c contains a 
mixture of JSF Facelets and HTML5 
markup. The Facelets markup is 
used for template purposes only, 
and if the page contained no 
Facelets markup, it would still func¬ 
tion properly with the JSF engine. 
Pass-through elements were intro¬ 
duced with JSF 2.2, and they are the 
reason that the HTML5 elements 
in Listings 2a, 2b, and 2c are pro¬ 
cessed as JSF components. 

To get started using HTML5 
elements with JSF, add the jsf 
namespace for the pass-through 
elements (xmlns:jsf="http://xmlns 
.jcp.org/jsf") to the page. The jsf 
namespace can be added to any 
HTML5 element attribute, allowing 
that element to be processed by 
the JSF runtime. Take a look at the 
<head> element: 

<head jsf:id="head"> 

The jsf:id="head" tells the JSF 


YOUR CHOICE 


JSF 2.2 lets 
developers 
choose to use 

JSF components, 
HTML5 elements, 
or both. 
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LISTING 2a / LISTING 2b / LISTING 2c 


Note: The following listing has been excerpted, as noted by the... symbol. The 
full code listing is available by downloading the code listings for this issue. 

<h:form id=" parkReservationForm" > 

<hl>Create Reservation</hI> 

<br/> 

<h:messagesid=" messages" 
infoStyle=" color: green;" 
errorStyle- 1 color: red;" /> 

<br/> 

<h:panelGrid columns- 1 2" > 

<label for=" firstName" >First:</label> 

<p:inputText id=" firstName" 

placeholder- 1 Enter First Name" 
value=" #{...firstName}" /> 


<label for=" numAdults" >Adults:</label> 
<p:spinnerid=" numAdults" min-T max="I5" 
value=" #{...numAdults}" /> 


<label for=" startDate" >Trip Start:</label> 
<p:calendarid=" startDate" 
value=" #{...tripStartDate}" /> 

</h:panelGrid> 

<h:commandButton id=" parkReservation" 
action="#{parkReservationController.createReservation}" 
value- 1 Create a Reservation" > 

</h:commandButton> 

</h:form> 


Download all listings in this issue as text 
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Figure 2 


engine to interpret this 
component as <h:head>. 
Similarly, reviewing an 
input component, we can 
see that attributes essen¬ 
tial for JSF processing are 
passed through to the JSF 
runtime. In the following 
inputText element, the 
id and value are passed 
through: 


| <input type="text" 

jsf:id="firstName" 
jsf:value="#{...}"/> 

As a result of the 
pass-through elements, 
the HTML5 element is 
treated as a first-class 
JSF h:inputText com¬ 
ponent that is associ¬ 
ated with a server-side 
UlComponent instance. 

To be treated as a JSF component, 
at least one element must contain 
the jsf pass-through namespace. 
This allows standard HTML5 
elements to accept Expression 
Language (EL) to retrieve and 
set managed bean properties. 
Therefore, when the form is sub¬ 
mitted (or element values are sent 
to the server via JavaScript), the 
values are sent to the managed 
bean and processed accordingly. 

Figure 2 shows what the HTML5 
page might look like. Note that 


this code uses the native HTML5 
calendar element, which might 
be rendered differently across 
various browsers. 

Sprinkling HTML5 into 
Existing JSF 

JSF and HTML5 play nicely 
together. In fact, an FITML5 ele¬ 
ment can be added into any exist¬ 
ing JSF view and function just as if 
it were a standard JSF component. 
However, in some cases, we might 
wish to use JSF components, 
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LISTING 3 


Note: The following listing has been excerpted, as noted by the... symbol. The 
full code listing is available by downloading the code listings for this issue. 

<h:form id=" parkReservationForm" prependld-'false" > 

<hl>Create Reservation</hl> 

<br/> 

<h:messagesid=" messages" infoStyle-'color:green;" 

errorStyle- 1 color: red;" /> 

<br/> 

<h:panelGrid columns-' 2" > 

<label for=" firstName" >First:</label> 

<h:inputText id=" firstName" 

placeholder-' Enter First Name" 
value=" #{...firstName}" /> 



<label for=" numAdults" >Adults:</label> 
<h:inputTextid=" numAdults" p:type=" number" 
p:min="l" p:max="15" 
value=" #{...numAdults}" /> 


<label for=" startDate" >Trip Start:</label> 
<h:inputText p:type=" date" id=" startDate" 
value=" #{...tripStartDate}" > 
<f:convertDateTime pattern- 1 YYYY-MM-dd" /> 
</h:inputText> 

</h:panelGrid> 

<h:commandButton id=" parkReservation" 
action-' #{...createReservation}" 
value=" Create a Reservation" > 
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but enhance them by specify¬ 
ing attributes that are available 
for use only via the component's 
HTML5 counterpart. Such a solu¬ 
tion is made possible using JSF 
2.2's addition of the pass-through 
attributes. Pass-through attributes 
are the converse of pass-through 
elements: a pass-through attribute 
is applied to a JSF component to 
signify that the specified attribute 
should be ignored by the JSF run¬ 
time and passed directly through 
to the browser. The resulting ele¬ 
ment will be the FITML5 equiva¬ 
lent of the JSF component, includ¬ 
ing all attributes. This capability 
allows you to specify any number 
of pass-through attributes for a JSF 
component, and they will be com¬ 
pletely ignored by JSF but rendered 
as FITML5 in the browser. This 
is a very handy feature, because 
FITML5 is still evolving and new 
attributes could be added in the 
future. The pass-through attri¬ 
bute feature of JSF 2.2 enables 
the specification of any current or 
future FITML5 attribute on a stan¬ 
dard JSF component. 

There are a few different ways to 
use pass-through attributes within 
your JSF views. One technique 
is to declare the pass-through 
namespace (xmlns:p="http:// 
xmlns.jcp.org/jsf/passthrough") 
within the JSF view, and then 
precede any HTML5 attributes 


within a JSF component with the 
namespace prefix. 

In Listing 3, the same form that 
was generated in the previous 
sections has been reimplemented 
using JSF components with pass¬ 
through attributes. Reviewing the 
first inputText component in the 
view, the HTML5 placeholder attri¬ 
bute has been specified, which 
allows a textual hint to be added 
to the text box on the rendered 
view. Because the placeholder attri¬ 
bute is not available on the input 
Text component, it must be passed 
through to the FITML5 rendering 
engine: 

I <h:inputText... 

p:placeholder="text here"... 

Similarly, pass-through attributes 
are used with inputText compo¬ 
nents to signify the type of com¬ 
ponent that should be rendered. In 
this case, HTML5 number and date 
elements will be rendered: 

<h:inputText... 
p:type="number"... 

<h:inputText... 
p:type="date"... 

If only a single pass-through 
attribute is needed, it is pos¬ 
sible to specify it by nesting the 

fpassThroughAttribute tag within 
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LISTING 5 / LISTING 6 


<h:inputText id=" startDate" value- 1 #{parkReservationCon- 

troller...tripStartDate}" > 

FpassThroughAttribute name- 1 type" value- 1 date" /> 

</h:inputText> 


P Download all listings in this issue as text 


a component tag. Listing 4 
demonstrates how to use the 

fpassThroughAttribute tag to spec¬ 
ify the type of an inputText com¬ 
ponent to render an HTML5 date 
element. The fpassThroughAttribute 

tag accepts name and value 
attributes to specify the type of 
attribute along with the value. 

To specify more than one attri¬ 
bute using this same technique, 
nest the f: passTh rough Attributes 
tag within a component tag, and 
use an EL expression to specify 
the value as a Map<String, Object> 
within the managed bean. The Map 
should be composed of a name/ 
value pair for each attribute to 
be used. Listing 5 demonstrates 
how to construct such a Map, and 
Listing 6 demonstrates how to 
specify the f:passThroughAttributes 
tag to render an HTML5 number 
element. All of the resulting forms 
will look similar to Figure 2. 


Stateless Views 

By default, JSF stores the state of all 
UI components after each request. 
With FITML5 and some of the pop¬ 
ular web frameworks today, state 
is sometimes becoming less of a 
requirement. For instance, if you 
are creating a login page, you typi¬ 
cally do not wish to persist stateful 
values in memory. Rather, you sim¬ 
ply want to pass the values through 
for processing, and then move onto 
the next task. A new feature in JSF 
2.2 is the ability to create stateless 
views. You can choose to mark a 
view as stateless by including the 
transient attribute on the fview tag, 
and specifying true as its value: 

<f:view transient="true"> 

If you are using a stateless view, 
it is important to use the proper 
session management within the 
managed bean. Therefore, 
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@RequestScoped should be 
specified on a managed bean, 
rather than @ViewScoped or 
@SessionScoped. 

Note: Be sure to use the javax 
.enterprise.context.RequestScoped 
annotation for a CDI application. 

Server-Side Templating 

A significant feature of JSF is its 
ability to perform server-side tem¬ 
plating. JSF ships with Facelets 
technology, which provides support 
for developing templates that can 
be applied across different views 
within an application. It can be 
advantageous to use server-side 
templating, even if you are develop¬ 
ing an application that harnesses 
the client, such as an FITML5/ 
JavaScript front end. The JSF 2.2 


feature known as Resource Library 
Contracts provides the ability to 
supply an alternative look and feel 
for different portions of one or more 
applications, without the need to 
use multiple templates for each. 

To make use of Resource Library 
Contracts, specify a contracts folder 
within your JSF application. Create 
one or more named contracts 
(directories) within that folder. Each 
contract should contain resources 
that are required for supplying the 
look and feel for that contract. For 
instance, suppose that the Acme 
World website had a different look 
and feel for those logged in as 
administrators. You could create 
two different contracts, by follow¬ 
ing an application structure such as 
that shown in Figure 3. 


Qa Web Pages 

▼ B 

WEB-INF 


faces-config. xml 


3 web.xml 

▼ cn 

admin 


jtf] menu.xhtml 

▼ a 

contracts 

w 

fj admin 


% css Layout, css 


\ default.css 


|iif] template.xhtml 

V 

standard 


csslayout.css 


^4 defaultcss 


@ template.xhtml 



Figure 3 Figure 4 
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LISTING 7 


<resource-library-contracts> 

<contract-mapping> 

<url-pattern>/admin/*</url-pattern> 

<contracts>admin</contracts> 

</contract-mapping> 

<contract-mapping> 

<url-pattern>*</url-pattern> 

<contracts>standard</contracts> 

</contract-mapping> 

</resource-library-contracts> 

P Download all listings in this issue as text 


To configure the contracts, 
specify the resource-library- 
contracts element within the faces- 
config.xml file accordingly. Listing 7 
demonstrates how to specify the 
configuration to use different tem¬ 
plates for both the standard and 
admin contracts in our example. 
All pages can specify the same 
template name, and the resource 
library contract handles the job 
of determining which template 
to apply: 

I <ui:composition 

template="/template.xhtml"> 

The template can also be pack¬ 
aged up in a JAR file so that it can 
be applied to more than one appli¬ 
cation, if desired. For more infor¬ 
mation, seethe Resource Library 
Contracts information in the Java 
EE 7 tutorial. 


WebSocket, HTML5, and JSF 

HTML5 solutions require fast com¬ 
munication, and WebSockets pro¬ 
vide that communication channel. 
WebSockets allow for full-duplex 
communication over a single 
TCP connection. What does this 
mean? Instead of sending separate 
requests for each transmission, 
a connection can be opened for 
two-way communication, remain 
open while needed, and then be 
closed when the communication 
is complete. 

This section is not a primer on 
WebSocket; to learn details regard¬ 
ing the technology, please refer 
to the WebSocket section of the 
Java EE 7 tutorial. Instead, this 
section will demonstrate how to 
develop an application that uses 
a combination of JSF and HTML5 
for the chat web view, along with 
WebSocket for communication. 
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In this example, we'll take a look 
at a simple chat view that uses a 
WebSocket connection to openly 
broadcast messages to all sessions 
connected to the same server end¬ 
point. The simplistic chat applica¬ 
tion is shown in Figure 4. 

Every WebSocket transmission 
follows a similar procedure: open 
the WebSocket connection, send 
messages from various clients 
to the WebSocket endpoint, and 
then close the connection. In our 
example, the user types in a chat 
username, and then clicks the Start 
Chat Session button to open a 
WebSocket communication chan¬ 
nel. Once that has been completed, 
the user can type messages and 
send them to the chat room. After 
the connection is established, the 
user will begin to see any messages 
sent to the WebSocket endpoint 
from other users. 

Listing 8 shows the source 
code for the simple chat room 
Facelets view, which contains three 
PrimeFaces commandButton com¬ 
ponents and a couple of FITML5 
text input elements. This mixture 
of JSF and FITML5 is used for inter¬ 
acting with theJSF backing bean 
and WebSocket endpoint, and the 
output of the chat (returned from 
the endpoint) is displayed within a 
div near the bottom of the form. 

The PrimeFaces command 
Button components commu¬ 


nicate with the JSF runtime via 
action attributes, which are bound 
to a backing bean identified as 
ChatController. They also communi¬ 
cate with the WebSocket connec¬ 
tion via JavaScript using the onclick 
event. Listings 9a and 9b show the 
JavaScript that is invoked via the 
button events. For instance, when 
the Chat button is clicked, the 
sendChatMessageQ JavaScript 
function is invoked, sending the 
message contained within the 
corresponding text box to the 
WebSocket endpoint. 

The WebSocket endpoint class 
is identified as ChatServerEndpoint 
(see Listings 10a and 10b). The 
@ServerEndpoint annotation 
marks the class as a WebSocket 
endpoint, and the encoders and 
decoders attributes are used to 
list the classes that can be used 
to translate the message for use. 
The value attribute contains a 
path that specifies the endpoint 
that is made accessible to clients. 

In this case, the WebSocket is 
accessible at ws://localhost:8080/ 
JavaMagazine-HTML5JSF/chat. 

The sendChatMessage() cli¬ 
ent JavaScript function encodes 
the message into a JSON object 
by stringing together the user- 
name and message into a JSON 
string of name/value pairs. It 
then sends the JSON string to the 
ChatServerEndpoint. When the 
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LISTING 9a / LISTING 9b / LISTING 10a / LISTING 10b 


<form jsf:id=" chatForm" jsf:prependld=" false" > 

Please enter a username to chat (a valid email address). 
<br/><br/> 

<label>Username:</label> 

<inputtype=" text" jsf:id=" username" 
jsf:value=" #{chatController.current.username}" /> 
<br/><br/> 

<p:commandButton onclick=" initiateChatSession();" 
update- 1 sendMessage jsfOutput" 
value- 1 Start Chat Session" 
action- 1 #{chatController.startSession}" /> 
<p:commandButton onclick- 1 closeChatSession()" 
update=" sendMessage jsfOutput" 
value=" Close Chat Session" 
action- 1 #{chatController.closeSession}" /> 
<br/><br/> 

Messages br/> 

<inputtype=" text" jsf:id=" message" 
jsf:value=" #{chatController.current.message}" /> 
<br/> 

<p:commandButton value- 1 Chat" id=" sendMessage" 
disabled=" #{!chatController.sessionOpen}" 
onclick- 1 sendChatMessagef)" 
action- 1 #{chatController.sendMessage}" /> 

<hr/> 

Session Content:<br/> 

<divid=" output" class- 1 chatOutput" > 

<h:outputText id=" jsfOutput" 
value=" #{chatController.chatOutput}" /> 

</div> 

</form> 


Download all listings in this issue as text 





























//enterprise java / 


endpoint receives the message, 
the method annotated with 
(©OnMessage is invoked, but it does 
not perform any message transla¬ 
tion, because a decoder (see 
Listing 11) is used to parse the 
object via the JSON-P API upon 
message receipt, and an encoder 
(see Listing 12) is used to put the 
resulting message into a present¬ 
able String to transmit to all clients. 

The ChatServerEndpoint class 
maintains a list of open WebSocket 
sessions, and each time a mes¬ 
sage is sent to the endpoint, it is 
broadcast to each session. The 
ChatController CDI backing bean 
(see Listing 13) is used for load¬ 
ing the current chat message into 
the session scope for further use, 
if needed. The username is also 
stored within the bean for any fur¬ 
ther use, and the bean maintains 
a Boolean indicating whether the 
chat session is active. 

This simple chat client demon¬ 
strates that both HTML5 and JSF 
can be used while working with 
WebSocket. You are encouraged to 
visit the Java EE 7 tutorial to learn 
more about WebSocket so that you 
can begin to create sophisticated 
solutions using this technology. 

HTML5 Development with 
NetBeansIDE 

The NetBeans IDE makes it par¬ 
ticularly easy to work with HTML5. 
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Figure 5 


For starters, when the NetBeans 
Connector extension is installed 
into a Chrome browser, a NetBeans 
action menu is added to Chrome, 
enabling features for making 
FITML5 development more pro¬ 
ductive. NetBeans provides a live 
preview of web pages, which allows 
automatic redeployment of pages 
upon save. Users can save changes 
and see the changes applied imme¬ 
diately within the web page if they 
are using Chrome or they are on 
mobile devices running Android or 
iOS. This feature enables automatic 
page refresh while making modifi¬ 
cations within FITML pages or JSF 
views alike. 
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LISTING 12 / LISTING 13 


public class ChatDecoder 
implements Decoder.Text<Chat> { 

(©Override 

public void init(final EndpointConfig config) { 

} 

(©Override 

public void destroy!) { 

} 

(©Override 

public Chat decode(final String textMessage) 
throws DecodeException { 

Chat chatMessage = newChat(); 

JsonObject obj = Json.createReader( 
new StringReader(textMessage)) 

.readObject(); 

chatMessage.setMessage(obj.getString("message" )); 
chatMessage.setUsername(obj.getString("username" )); 
chatMessage.setChatDate(new DateQ); 
System.out.println("decoder..." ); 
return chatMessage; 

} 

(©Override 

public boolean willDecode(final String s) { 
return true; 

} 

} 
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Speaking of mobile development, 
NetBeans provides responsive web 
design capability, allowing develop¬ 
ers to choose the layout of choice 
within the browser plugin (see 


Figure 5). Using the plugin, content 
can be dynamically reformatted to 
size, depending upon the selected 
dimensions. This enables develop¬ 
ers to see what their applications 




































//enterprise java / 


might look like across the screens 
of different devices. 

NetBeans provides excellent code 
completion when working with 
HTML5 elements, JSF components 
(even if you are using a library such 
as PrimeFaces), JavaScript, CSS, 
and more. This makes develop¬ 
ment more productive; rather than 
parsing through documentation, 
the available options can be dis¬ 
played onscreen as code is typed. 


For instance, when typing CSS tags, 
pressing the Ctrl and space keys 
simultaneously will provide CSS 
rule code completion (see Figure 6). 

The NetBeans IDE also includes 
an FITML5 project type. These proj¬ 
ects enable full support for libraries 
such as AngularJS, Knockout, and 
more. It is even simple to develop 
a Cordova application and deploy 
directly to a mobile device. These 
are just a few of the options that 
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are made available to developers 
using NetBeans. NetBeans IDE is 
one of the best choices available for 
FITML5 and JSF development. 

Conclusion 

JSF plays an important role in Java 
web development. With the release 
of Java EE 7, JSF has been enhanced 
to provide seamless integration 
with FITML5, enabling JSF develop¬ 
ers to take advantage of the fea¬ 
tures that HTML5 has to offer, and 
vice versa. Developers can mix and 
match the two technologies to suit 
their needs, enabling the develop¬ 
ment of sophisticated applications. 

JSF also works well with HTML5- 
geared APIs such as WebSocket and 
JSON-P. This article demonstrated 
solutions integrating these technol¬ 
ogies, and showed howto harness 
an IDE such as NetBeans for build¬ 
ing these solutions. </article> 
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HARSHAD OAK 


Build with NetBeans IDE, Deploy to 
Oracle Java Cloud Service 

Save time and effort deploying applications. 


BIO 


Development 
Tools and 
Techniques 


I n a previous Java Magazine 
article. I described how 
you could go about choos¬ 
ing a Java platform-as-a- 
service (PaaS) provider and 
introduced Oracle Java Cloud 
Service. In this article, we will 
look at how you can swiftly 
build and deploy applications 
to Oracle java Cloud Service 
using NetBeans IDE. 

Most java PaaS platforms 
provide web dashboards with 
the ability to deploy applica¬ 
tions packaged into WAR and 
EAR files. PaaS providers also 
provide Ant and Maven tools 
to help streamline the build 
and deployment process. 
Some, such as Oracle java 
Cloud Service, go a step fur¬ 
ther and provide integration 
with multiple popular IDEs 
such as NetBeans, Eclipse, 
and Oracle jDeveloper. IDE 
integration is great for devel¬ 
opers because it can lead to 


significant savings of time 
and effort. In this article, we 
will focus on using the new 
NetBeans IDE 8 with Oracle 
java Cloud Service. 

Note: The source code for 
the application described 
in this article can be down¬ 
loaded here. 

Installing the Oracle java 
Cloud Service SDK 

Before we get to the NetBeans 
integration, we first need 
to set up the Oracle java 
Cloud Service Software 
Development Kit (SDK), 
because all IDEs use the SDK 
to interact with Oracle java 
Cloud Service. 

The SDK comes with tools 
to help you develop, deploy, 
and manage applications on 
Oracle java Cloud Service. For 
example, it provides com¬ 
mands for interacting with 
Oracle java Cloud Service, 


a whitelist tool for 
checking your appli¬ 
cation's deployment 
readiness, and Ant 
tasks and Maven 
plugins. 

Note that the SDK 
is not a set of classes 
or libraries that you 
have to use in your 
application code. 

To install the SDK, 
download the latest 
version from Oracle 
Technology Network 

and then extract 
the contents of the 
downloaded file to a 
directory. 

Getting a Trial Version of 
Oracle java Cloud Service 

Next, install a 30-day trial 
version of Oracle java Cloud 
Service from cloud.oracle 
.com. Once your trial version 
is registered, you will receive 


information about 
the data center, 
the username, the 
password, and the 
identity domain 
foryour trial. Keep 
that information, 
because you will 
need it when we 
explore how to 
use Oracle java 
Cloud Service from 
NetBeans. 

Note that the 
trial version also 
includes a trial of 
Oracle Database 
Cloud Service. So 
you do not need to get a sep¬ 
arate trial version of Oracle 
Database Cloud Service. 

Setting Up NetBeans 

One of the many nice fea¬ 
tures of NetBeans is its easy 
installation. Download either 
the java EE version or the 


It will only be a 
matter of time 
before we will 
all be building 
software 
using IDEs that 
integrate 
with multiple 
cloud 
services. 
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Figure 1 


"All" version of NetBeans from 
netbeans.org. Install NetBeans 
and you are ready to go with all the 
standard capabilities. 

Having said that, installing even 
the "All" version does not mean 
that all features will be activated 
right away and start taking up 
resources. NetBeans has a neat 
"Feature On Demand" capabil¬ 
ity that enables a technology only 
when you actually use it. 

Installing the Oracle Cloud Plugin 

Once NetBeans is set up, we next 
need to install the Oracle Cloud 
plugin for NetBeans. To do that, in 
NetBeans click Tools -> Plugins and 
then click the Available Plugins tab. 


There, search for cloud and you will 
see the plugin listed, as shown in 
Figure 1. Ensure that the checkbox 
for the plugin is selected and then 
click Install. Then follow the steps in 
the NetBeans IDE Plugin Installer to 
install the Oracle Cloud plugin. 

Once the plugin is installed, you 
will find that a new "Cloud" section 
has been added to the Services 
window, as shown in Figure 2. If you 
are unable to see the Services win¬ 
dow, enable it by clicking Window 
-> Services in the NetBeans menu. 

Note that you can always use the 
Window -> Reset Windows option 
in the NetBeans menu to get back 
the default windows and the famil¬ 
iar look and feel. 
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Figure 3 


Now, right-click Cloud and select 
Add Cloud. You will see the Add 
Cloud Provider screen. Select 
Oracle Cloud and then enter the 
information you got when you 
installed the trial version of Oracle 
Java Cloud Service, as shown in 
Figure 3. Note that in the SDK field, 
you need to specify the path to 
where you extracted the Oracle 
Java Cloud Service SDK. Also, if your 
data center is not listed in the Data 


Center list, type in your data cen¬ 
ter's name. 

As seen in Figure 3, NetBeans 
recommends that you register a 
local instance of Oracle WebLogic 
Server, which you can use dur¬ 
ing development. There's nothing 
stopping you from using the cloud 
environment even during develop¬ 
ment; however, it will be faster and 
easier to deploy and debug code 
locally than in the cloud. Oracle 
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Java Cloud Service runs Oracle 
WebLogic Server llg. Download it 
here and then install it, so you will 
have a local server running. 

Once your cloud is set up, you 
will find a new server and a "wel¬ 
come app" listed, as shown in 
Figure 4. You can right-click the 
app to view, stop, or undeploy it. 
You can also access the Jobs Log 
and the Instance Log from within 
NetBeans by right-clicking Oracle 
Cloud and then clicking View Jobs 
and Logs. 

Now that NetBeans is integrated 
with Oracle Java Cloud Service, let's 
next look at building a Java EE 
application that will use Oracle 
Java Cloud Service as well as Oracle 
Database Cloud Service. 

Note that if you enabled the 
"Feature On Demand" capability 
while installing NetBeans and this 
is your first use of the Java EE capa¬ 
bilities of NetBeans, it might take 
NetBeans some time to activate 
Java EE. Also, if you chose to install 
Apache Tomcat or GlassFish dur¬ 
ing installation, you will find them 
also now listed under Servers in the 
Services window. 

Building a Java EE Application 

First, select New -> Java EE -> 
Enterprise Application. Enter 
JavaMag for the name of the proj¬ 
ect and click Next. In the New 
Enterprise Application screen, 
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which is shown in Figure 5, select 

Oracle Cloud Remote from the 
Server list. 

Oracle Java Cloud Service cur¬ 
rently supports a mix of technolo¬ 
gies from Java EE 5 and Java EE 6, 
as described here. NetBeans selects 
Java EE 5 and a source level of 1.5. 

Then select the Create 
EJB Module and Create Web 
Application Module checkboxes. 
Click Finish and NetBeans will cre¬ 
ate the modules. 

In our application, we will use a 
Java Persistence API (JPA) entity, 
a stateless session Enterprise 
JavaBean (EJB), and a servlet to 
create a new magazine record in 
the database. 

We will begin by creating a new 
JPA entity named Magazine. Right- 
click the JavaMag-ejb project and 
select New -> Persistence -> 

Entity Class. As shown in Figure 6, 
enter Magazine in the Class Name 
field, select entities from the 
Package list, and ensure that the 
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Figure 7 


Create Persistence Unit checkbox 
is selected. Then click Next. 

In the New File screen, which is 
shown in Figure 7, enter the Data 
Source name for the trial version 
of Oracle Database Cloud Service 
that you got with your trial ver¬ 
sion of Oracle Java Cloud Service. 

You will see this 
name listed in 
the Data Sources 
section upon 
logging in to 
the Oracle Java 
Cloud Service 
web-based 
dashboard. 

Oracle Java 
Cloud Service 
supports J PA 2.0, 
so EclipseLink 


for JPA 2.0 is selected. Note that the 
Create option is the default selec¬ 
tion for Table Generation Strategy, 

so a new Magazine table will be 
created when we attempt to persist 
new magazine information using 
the Magazine JPA entity. 

NetBeans will generate the 
entity class file Magazine.java in 
the package entities. It will also 
generate a persistence.xml file 
where you will find the persistence 
unit configuration. 

As shown in Listing 1, which is 
an excerpt from Magazine.java, 
NetBeans will add all the requisite 
annotations to specify that the 
class is an entity. In Listing 1, the 
GenerationType.AUTO annotation 
for the id property means that the 
persistence provider will pick an 



Oracle Java Cloud 
Service goes a 
step further 

and provides 
integration with 
multiple popular 
IDEs. 
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LISTING 1 LISTING 2 


@Entity 

public class Magazine implements Serializable { 
private static final long serialVersionUID = 1L; 

@Id 

@GeneratedValue(strategy = GenerationType.AUTO) 
private Long id; 

private String name; 
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appropriate strategy based on the 
database. EclipseLink typically will 
create a new table for the key gen¬ 
eration, because that's a strategy 
that will work across databases. 

Now let's add a name property 
to the Magazine entity. To do that, 
right-click in the code and select 
Insert Code -> Add Property. In 
the screen that opens, enter the 
property name as name and select 
the option to generate getter and 
setter methods. 

Next, we will create a new state¬ 
less session bean through which 
we will use the Magazine entity. 
Right-click the JavaMag-ejb project 


and select Enterprise JavaBeans -> 
Session Bean. 

As shown in Figure 8, enter 
AddMagazineBean for the name 
of the bean, select ejb from the 
Package list, and select Stateless 
for the session type. 

Note that because Oracle Java 
Cloud Service supports EJB 3.0, you 
don't get the "no interface" option 
that was introduced in EJB 3.1. 

Also, Oracle Java Cloud Service 
supports only local EJB invoca¬ 
tions, so select Local for the type 
of interface to create. 

Click Finish. NetBeans will 
generate the AddMagazineBean 
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bean along with the 
AddMagazineBeanLocal interface. 

Now select Insert Code -> Add 
Business Method to add a new 


addMagazine method to the ses¬ 
sion bean. Note that NetBeans will 
add the method signature to the 
local interface. 

To add the new 
magazine to the 
database, we need 
to use the entity that 
we created earlier. 

To use the entity, we 
need to inject the 
EntityManager. To do 
so, right-click in the 
code and select Insert 
Code -> Use Entity 
Manager. NetBeans 
will add the depen¬ 
dency injection code 
for EntityManager 
as well as a persist 
method. We will use 
the persist method, 
as shown in Listing 2, 
and pass it an object 
of the Magazine entity. 

We now have our 
entity and the session 
bean created in the 
JavaMag-ejb project. 
Next, we need to add 
a web component in 
the JavaMag-web proj¬ 
ect, which will use the 
AddMagazineBean to 
add a new magazine 
to the database. 

Add a servlet to the 
JavaMag-web project 



Figure 8 



Figure 9 
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LISTING 3 LISTING 4 


@EJB 

private AddMagazineBeanLocal addMagazineBean; 

P Download all listings in this issue as text 


by right-clicking the project and 
selecting Web -> Servlet. Name the 
servlet MagazineServlet and name 
the package servlets. Click Finish. 

Now, to call the session bean 
from the servlet, right-click in 
the code and select Insert Code 
-> Call Enterprise Bean. Specify 
AddMagazineBean, as shown in 
Figure 9. 

As shown in Listing 3, NetBeans 
will add the dependency injection 
with the @EJB annotation to the 
MagazineServlet. 

We will next add a line in the 
processRequest method to call the 
bean and add a new magazine, as 
shown in Listing4. 

We now have our entity, the ses¬ 
sion bean, and the servlet in place, 
so we can deploy the application. 
Right-click the JavaMag enterprise 
application and click Run. Check 
the contents of the "JavaMag (run)" 
log in NetBeans and you will find 
that NetBeans built the WAR file for 
the web application module, built 
the JAR file for the EJB module, and 
packaged the two into an EAR file. 

It then uploaded the EAR file to 
Oracle Java Cloud Service. 


As shown in Figure 10, 
the "Oracle Cloud Remote 
Deployment" log lists the activi¬ 
ties being performed in the cloud. 

It shows that the cloud service 
first performs a virus scan, then a 
whitelist check, and then the 
actual deployment. 

Once the deployment is com¬ 
plete, your default browser will 
open up and point to the index 
.jsp page in the application we 
deployed. Because we want to run 
the MagazineServlet, change the 
URL in the browser to /JavaMag- 
war/MagazineServlet to call the 
servlet. You will get output similar 
to what's shown in Figure 11. 

By default, Oracle Java Cloud 
Service will want you to login to 
your cloud service before you can 
access your servlet. However, if you 
wish to make the application public 
and you do not want any authenti¬ 
cation, add an empty <login- 
config/> tag to the web.xm file. 

Upon executing the servlet, select 
Sql Workshop -> Object Browser in 
Oracle Database Cloud Service. You 
will find that a new table named 
Magazine has been created and a 
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JavaMag (run) 


Oracle Cloud Remote Deployment m 


Uploading... 

Deploying. 

==================== Log file: virus-scan : 


2014-03-11 00:39:12 CDT: 
2014-03-11 00:39:12 CDT: 
2014-03-11 00:39:51 CDT: 
2014-03-11 00:39:51 CDT: 
2014-03-11 00:39:51 CDT: 
2014-03-11 00:39:51 CDT: 
2014-03-11 00:39:51 CDT: 
2014-03-11 00:39:51 CDT: 
2014-03-11 00:39:51 CDT: 


Starting action "Virus Scan" 
Vi rus S c an st art e d 


File Scanned: 11 Javal-lag. ear " . 

File Size: "9904765". 

File St atus: "CL FAN". 


Virus scan passed. 

"Virus Scan" complete: status SUCCESS 


Log file: whit e1ist 


2014-03-11 00:39:51 CDT: Starting action "API Uhitelist 

Figure 10 
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Servlet MagazineServlet at /JavaMag-war 
New Magazine Added 


Figure 11 


new "Java Magazine" record has 
been inserted in the table. 

Conclusion 

In this article, we saw how to 
quickly set up and use NetBeans 
to develop a Java EE application 
and deploy it to Oracle Java Cloud 
Service. Considering the rapid 
adoption of cloud-based services, 
it will only be a matter of time 
before we will all be building soft¬ 
ware using IDEs that integrate with 
multiple cloud services for various 


stages in the software develop¬ 
ment process. </article> 

MORE ON TOPIC: 


Development 
Tools and 
Techniques 


ALEARN MORE 

• Oracle Java Cloud Service 

• Oracle Database Cloud Service 

• NetBeans IDE 

• Oracle Java Cloud Service SDK 
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MICHAEL HUTTERM ANN 


Mastering Binaries with Hudson, 
Maven, Git, Artifactory, and Bintray 

A powerful tool chain that can be the backbone in a build/release and delivery pipeline 



I n this article, we discuss 
patterns for mastering bina¬ 
ries in Maven-based projects. 
We differentiate between 
version control systems and 
component repositories as 
well as Maven releases and 
Maven snapshots. We talk 
about automatic releasing 
and explore a tool chain that 
integrates Hudson, Maven, 
Git, Artifactory, and Bintray 
to be a backbone in a build/ 
release and delivery pipeline. 

Now let's start by setting 
the stage with some impor¬ 
tant aspects of continuous 
integration (Cl) and continu¬ 
ous delivery (CD). 


Cl and CD 


Development 
Tools and 
Techniques 


Cl includes code integrations 
that are run at least on a daily 
basis. The word continuous, 
as used in this context, 
denotes a repeatable pro¬ 
cess that occurs regularly and 


frequently. The word integra¬ 
tion means that individually 
developed pieces of code 
that are stored in a source 
code repository are checked 
out as a whole; then they're 
compiled, packaged, tested, 
inspected, and deployed with 
build results integrated into 
web pages, sent out as an 
e-mail, or both. 

Building and integrating 
software as soon as develop¬ 
ers check in their changes 
is called continuous build. 

A release build (or a release 
candidate build) is often the 
build that pulls a specific ver¬ 
sion (which was tested before 
successfully) from the ver¬ 
sion control system (VCS) and 
creates a new baseline from 
that. The build server acts 
as a "single point of truth," 
so builds can be used with 
confidence for testing or as a 
production candidate. 


With CD, you implement 
delivery pipelines, also called 
build staging, according to 
your corporate standards. 

For example, validating spe¬ 
cial quality requirements on 
higher build stages prevents 
code from being promoted 
before it's ready. The initial 
staging area is the developers' 
workspaces. Operationally, 
build pipelines often 
consist of different 
build jobs that are 
triggered automati¬ 
cally or manually and 
might have depen¬ 
dencies on each 
other. We talk about 
builds, but what 
exactly is a build? 

Builds 

A build is a stan¬ 
dard, repeatable, 
and measurable 
compilation and 


packaging process done 
automatically. The specific 
steps of this process can 
vary. Some argue that build¬ 
ing means compiling. Others 
might include in the process 
a preparation of the system, 
working on baselines in the 
VCS, compiling sources, run¬ 
ning different sorts of tests, 
applying the "infrastructure 
as code" paradigm 
(for example, with 
Chef or Puppet), and 
packaging and dis¬ 
tributing the config¬ 
uration items. Build 
can also refer to the 
greater automation 
flow, including static 
code analysis, unit 
testing, and deploy¬ 
ment. The output 
(the deliverables) of 
this process is often 
called a build, but 
from now on, we 


TAKE NOTE 


Be aware that 

even early in 
the process, 

you should 


environments 
that match 
those you’ll use 
in production. 
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Update and check-in 



Artifacts 

Physically existing files 

Created manually 

Created automatically 

Project plans, 
meeting 
minutes, ... 

Code, tests, ... 

Co d e libraries 

Generated 

documentation 




No config 
management 


Version 
ma nagement 

Distribution 

management 

□ 

_ 

_ J 




No config 
management 


V_ ^ ^ ^ _ . 

Figure 1 

will call it an artifact. 

The changes from multiple 
developers are integrated con¬ 
tinuously and automatically. Each 
version of the build is the basis of 
later releases and distributions. As 
shown in Figure 1, a build—local 
and central ones—checks out and 
may update sources from the VCS 
and consumes and produces arti¬ 
facts from and to a component 
repository (also called a binary 
manager or distribution manage¬ 
ment). Version control and distribu¬ 
tion management are in place and 
are complementary. 

The artifact is configurable and 
runs on different target environ¬ 
ments, including Windows and 
Linux machines ("build once, 
configure anywhere"). Be aware 
that even early in the process, you 
should use environments that 
match those you'll use in produc- 


Figure 2 

tion. With CD, promoting versions 
to higher staging environments is 
often a one-click event, where a 
lead engineer, a release manager, 
a deployment manager, or the 
domain expert pulls a new version 
to be deployed and configured to 
a defined target environment. An 
environment is all of the resources 
that your application needs to work 
and their configuration, as well as 
the hardware configuration (includ¬ 
ing CPUs, memory, and spindles) 
and the configuration of the operat¬ 
ing system and middleware (includ¬ 
ing messaging systems and web 
servers). The term infrastructure 
summarizes all of the environments 
in your organization together with 
supporting services, such as fire¬ 
walls and monitoring systems. 

As shown in Figure 2, parts of 
each artifact are held in version 
control, and other parts are held in 


Application 


distribution management. The con¬ 
figuration management discipline 
calls all those artifacts configuration 
items. Configuration management 
decides whether to put artifacts 
into version control or into distribu¬ 
tion management. 

Now let's explore version con¬ 
trol and distribution management 
(component repositories) in detail. 

Version Control 

Generally, it's important to archive 
your artifacts, but which types of 
artifacts you store where depends 
on the project context and the 
requirements. Coding artifacts— 
particularly source code, build 
scripts, and infrastructure as 
code—should be stored in the VCS. 
Although this sounds obvious, it's 
not always the case. Many projects, 
for example, patch their applica¬ 
tions in production without hav¬ 


ing those changes under source 
control. In addition to source code, 
tests and build scripts need to be 
versioned as well as Puppet mani¬ 
fests or Chef cookbooks. The lat¬ 
ter is often referred to as DevOps, 
although DevOps is much more 
than that. 

I recommend that you external¬ 
ize (and version) your runtime con¬ 
figuration settings. It's best practice 
to control all variable configuration 
values externally. Additionally, you 
should set up one central reposi¬ 
tory to store your assets, to avoid 
having multiple places where 
documentation might be located 
(for example, the VCS, a file shar¬ 
ing server, and your favorite e-mail 
system, all in parallel). 

When you check your artifacts 
into the VCS, you'll have to decide 
how to arrange the files in the 
system and decide who works on 
which stream and why. The rule of 
thumb here is that you shouldn't 
open any additional streams for 
longer than necessary, even with a 
distributed VCS such as Git. 

Component Repositories 

Often it's necessary to reproduce 
software that's running on differ¬ 
ent machines. It can, therefore, 
be useful for a central release or 
configuration management depart¬ 
ment to label final versions of the 
software and put the build artifacts 
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into a specific build archive, often 
called a definitive media library. 

This ensures binary integrity, which 
means that the same deployment 
units are delivered to each target 
environment (there's no recompi¬ 
lation for further environments), 
and source code is always linked to 
produced binaries. 

A component repository can also 
protect company assets and boost 
reusability. In the Java ecosystem, 
the binary versions are those from 
the standardized set of deploy¬ 
ment units, such as JAR, WAR, and 
EAR files. Full-fledged component 
repositories offer many features 
including search capability, role- 
based permission systems, trans¬ 
actional handling of binary access, 
and much more. Now that we've 
differentiated between the VCS and 
component repositories, you're fit 
for automatic releasing. 

Automatic Releasing 

During automatic releasing, which 
is fundamental for a CD initiate, 
major parts of the release process 
are performed by scripts and tool 
chains. In this process, the whole 
team profits from automation and, 
under optimal conditions, a specific 
button is simply pressed to pro¬ 
mote automatically created snap¬ 
shot versions to release candidates 
or to promote release candidates to 
release status. 


Prerequisites of a holistic auto¬ 
matic releasing process include 

■ Use highly integrated tool chains 
consisting of lightweight tools, 
for example. Hudson or Maven. 
that can be chosen and orches¬ 
trated as needed. 

■ Put configuration items (including 
sources, database scripts, mid¬ 
dleware, infrastructure, configu¬ 
ration files—such as Java prop¬ 
erties files—and build/deploy 
scripts) into version control. 

■ Wherever possible, use declara¬ 
tive formats (for example, Puppet 
manifests and Chef cookbooks) 
to set up the automatic releasing 
process. 

■ Declare (explicitly) and isolate 
dependencies of application, 
middleware, and infrastructure. 

■ Apply Cl that continuously 
synchronizes the work of your 
colleagues. 

■ Distinguish between VCSs (such 
as Subversion and Git), where 
you hold your sources, and com¬ 
ponent repositories (such as 
Artifactory and Nexus), where 
you hold your software binaries. 

■ Build binaries once and deploy 
them to target systems by 
configuration (in other words, 
runtime configuration data is 
not packaged into the binaries 
in a static fashion; rather, the 
application is configured 
during deployment time or 
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upon startup). 

■ Keep environments 
similar between devel¬ 
opment and opera¬ 
tions (keeping them 
equal is not practical 
because of costs, ben¬ 
efits, and different 
nonfunctional require¬ 
ments in specific 
environments). 

■ Define a process (and 
also one for patch¬ 
ing and merging back 
changes in production 
versions). 

■ To ensure reproduc¬ 
ibility, ensure that 
delivered software 
is solely built by the 
build server and is neither built 
manually nor patched or built on 
developers' desktops. 

It's critical to understand that 
automation is important in order to 
gain fast feedback. Don't just auto¬ 
mate because automating defined 
activities is so much fun, although 
this is a good motivator as well. 

When running an automatic 
releasing process with Maven, you 
need to take special care of Maven 
snapshots and Maven releases, 
which we discuss next. 

Snapshots and Releases 

First, it's important to consider 
build hygiene while releasing and 


working with Maven 
projects. For instance, 
a release build (in 
Maven terms, that is 
every version without a 
-SNAPSHOT in its ver¬ 
sion element) includes 
only frozen versions of 
both the produced and 
consumed artifacts. You 
might want to check this 
by using the convenient 
Maven Enforcer plugi n. 

or you might want to 
adjust your project object 
model (POM) accordingly 
with the help of Maven's 
Versions plug in. 

Let's make this even 
clearer by introducing a 
very small example. Let's imagine 
we want to play around with lamb¬ 
das in a freshly built Java SE 8 appli¬ 
cation that looks like Listing 1. 

To build this in a reproducible 
way, we just set up a minimalistic 
Maven POM, as shown in Listing 2. 
Take note of the compiler settings. 
We use Java 8 for both source and 
target to be able to use and compile 
the lambda expression. 

Now look at the version ele¬ 
ment. We've introduced a variable, 
S{myVersion}, for the version that 
can be passed through while start¬ 
ing the Maven build. The param¬ 
eterized version number is often 
a good approach during releas- 


BEST PRACTICES 


I recommend that 

you externalize 
(and version) 
your runtime 
configuration 
settings. It’s 
best practice 
to control 
all variable 
configuration 
values externally. 
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Figure 3 


ing. We can just call a build—for 
example, with mvn clean install 
-DmyVersion=1.0.0-GA —and the 

produced binary will have the 
correct version. This way we can 
easily create releases candidates 
or release continuously, without 
the overhead of frequently patch¬ 
ing the POM files with respective 
version numbers. The drawback is 
that the POM, as part of a baseline 
in your VCS, does not contain the 
concrete version number. This can 
be a showstopper, depending on 
project constraints and governance 
requirements. 

Often a project team feels com¬ 
fortable using Maven snapshots 
during development and providing 
releases for deployment to target 
environments. Take note: the term 
deployment is heavily overloaded. 
Please differentiate between 
deploying artifacts to a component 
repository—that means publishing 


binaries to it—and deploying arti¬ 
facts to an application server (that 
is, the runtime container for the 
application). In this article, I don't 
cover any deployments of WAR files 
or EAR files to application servers. 
It's important to understand that 
although it's often fine to work with 
Maven snapshots during develop¬ 
ment and deploy them to a compo¬ 
nent repository, it's seldom a good 
idea to deploy snapshots to an 
application server on a higher inte¬ 
gration test environment. 

Let's now look at a different 
approach for what releasing can 
look like by designing an appropri¬ 
ate delivery pipeline. Keep in mind 
that for that, we've changed the 
POM file and replaced the version 
variable with O.O.l-SNAPSHOT. 

A Delivery Pipeline 

Let's go through the essentials 
of the solution and discuss some 
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LISTING 1 LISTING 2 


package com.huettermann; 
import java.lang.System; 
y** 

* Hello world! 

*/ 

public class App 
{ 

public static void main(String[] args) { 

Runnable r = () -> System.out.println("Hello World!"); 

Thread t = new Thread(r); 

t.start(); 

} 

} 


Download all listings in this issue as text 


common recipes for a Hudson build 
pipeline that has three build stages 
triggered continuously on each Git 
commit (see Figure 3). Be aware 
that, in practice, you'll probably 
want to set up a holistic pipeline, 
which might consist of multiple 
subpipelines. All build jobs have the 
Git integration configured pointing 
to the central master repository. 


Stage 1. The first stage is triggered 
automatically on each commit in 
Git. Code is compiled, tested, pack¬ 
aged, and installed locally on the 
build server. Choose your build 
server topology wisely, for example, 
by scaling out horizontally and run¬ 
ning builds only on build slaves, not 
on the master. 

After the Maven build step mvn 
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clean install runs successfully, the 
produced binary is placed in the 
folder named "target" of the build 
job's workspace and installed into 
the local Maven repository, which, 
depending on your configuration, is 
either in the home directory of the 
user running Hudson or another 
place local to your Hudson builds. 
According to the Maven approach, 
the artifact is named cat-O.O.l 
-SNAPSHOT.jar, which is the concat¬ 
enation of the artifactld (cat), the 
version (O.O.l-SNAPSHOT), and the 
deployment type (.jar). 

After we've produced the artifact, 
we can place it into an exchange 
medium for later reuse, for example, 
for sharing among developers, or 
later use between development and 
operations. Often, this is a compo¬ 
nent repository such as Artifactory, 
for both snapshots and releases, or 
Bintray, for releases only. 

In our case, as part of the pipe¬ 
line, we want to locally reuse the 
freshly created artifact in down- 
streamed build steps and check 


its quality before we distribute it 
to any teams. Thus, we go for the 
approach of temporarily archiving 
the artifact on the file system. We 
could also move and exchange arti¬ 
facts across build slaves, but let's 
keep it simple here and focus on 
the scope of this article. 

So let's copy the file to a transfer 
folder by squeezing some shell 
commands into a Hudson "execute 
shell" script build step, as shown in 
Listing 3. 

Although there are options 
for versioning scripts and track¬ 
ing changes in Hudson, for bet¬ 
ter maintainability, in real project 
life, you often want to put your 
shell scripts into the VCS as well. 
Because we later need the project 
version and the Git checkout hash, 
we now extract and store that 
information. Let's start with the 
version of the Maven-based project 
(see Listing 4), which is also part of 
the dedicated Hudson build step. 

Many possible ways exist for 
extracting the version number. 

We've decided to use 
some sed commands, 
and store the version 
number in a Java 
properties file named 
version.properties. 
Given the version 
O.O.l-SNAPSHOT, 
the file afterward 
includes the key/ 



Figure 4 
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LISTING 4 / LISTING 5 


#!/bin/sh 

rm -rf/home/michael/talk/transfer 
mkdir /home/michael/talk/transfer 
cp devops/target/*.jar /home/michael/talk/transfer 


Download all listings in this issue as text 


value pair version=0.0.1-SNAPSHOT. 

Because we later want to cherry- 
pick a tested version to promote 
to be a release, we also store and 
visualize the Git hash, that is, the 
commit that was built successfully 
by Hudson. For that, we've coded a 
Groovy postbuild action, similar to 
Listing 5. 

This script adds the first eight 
characters of the hash to the build 
history of the build job for later ref¬ 
erence; see Figure 4, which shows 
an enriched build history. Git com¬ 
mits at your fingertips. 

Finally, Stage 1 triggers the down¬ 
stream build job. In our case, this is 
Stage 2; thus, we add this build job 
to be Hudson's target destination 
of the "Trigger parameterized build 
on other project." Here, don't forget 
to passthrough parameters you 
want to use later from inside down¬ 
stream build jobs. In our case, we'll 
need the Git commit hash; thus, we 
configure to pass through the "Git 
commit that was built." Let's now 
move forward to Stage 2. 


Stage 2. Stage 2 is an example 
dummy stage that illustrates any 
further activities on the previously 
built artifact or code baseline. 
Please imagine some heavy pro¬ 
cessing here, testing, and many 
more helpful things. 

If you need to access the sources 
from version control, it's important 
to not rely only on Hudson's Git 
plugin. It's more stable to trigger a 
git checkout SGIT_COMMIT as the 
first build step in that particular 
build job of Stage 2. This ensures 
that the build job does work on 
exactly the same Git commit as the 
build job of Stage 1. 

Closing Stage 2, we trigger Stage 3 
with the same approach that we 
used to call Stage 2 from Stage 1. 
Additionally, we now add 
"Parameters from properties file" 
while configuring the "Trigger 
parameterized build on other proj¬ 
ect" section. Here, we use the prop¬ 
erties from file /home/michael/ 
talk/transfer/version.properties, 
which was created during Stage 1. 
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It's sometimes a bit tricky to make 
context information and environ¬ 
ment variables available in Hudson 
build jobs. By passing the proper¬ 
ties file, its key/value are made 
available to the downstream build 
job dynamically. 

Stage 3. Our last stage contains the 
integration with the component 


repository, that is, deploying arti¬ 
facts. If everything went well until 
now, nothing breaks, and no qual¬ 
ity gates are missed, we can now 
deploy the previously created arti¬ 
fact to the component repository. 

What has to be done? First of 
all, we add a shell build step to the 
newly created Hudson build job 
for Stage 3. To be more 
consistent and to docu¬ 
ment what's going on, 
the build step copies the 
previously created artifact 
to the workspace local to 
this build job, as shown in 
Listing 6. 

Now we need to con¬ 
figure the component 
repository, in our case, 
Artifactory. Artifactory is a 
component repository that 
can be smartly integrated 
with Hudson. It serves as 
a tool for artifact exchange 
and provisioning across 
all artifact types, includ¬ 
ing Java, Linux RPMs, and 
many more. 

In the Hudson build 
job, we now configure the 
desired Artifactory target 
repository—that is, a logi¬ 
cal target path in the over¬ 
all repository. Side note: 
having the Git baseline 
as well, it would be easy 
to just rebuild the Maven 


Build History t trend ! 
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► O libs-releases-st aging-local 
- e libs-snapshots-local 
▼ O com 

▼ O huettermann 
▼ CD cat 

-r Q O.O.I-SNAPSHOT 

► a cat-0.0.1-20140206..100448-1 Jar 

► cat-0.0.1-20140206.101610-1 .jar 

► a cat-0.0.1-20140207.185720-1 .jar 

► Si cat-0.0.1-20140207.190126-1 jar 

► cat-0.0.1-20140207.190323-1 Jar 

► cat-0.0.1-20140207.190828-1 .jar 

► a cat-0.0.1-20140210.151126-1 .jar 

► 3l cat-0.0.1-20140210.151524-1 .jar 

► g l cat-o.o.i-2oi402io.i52523-i.jar 

► dl cat-0.0.1-20140210.152725-1 .jar 

► Q org 
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LISTING 6 LISTING 7 


#!/bin/sh 
rm *.jar 

cp /home/michael/talk/transfer/*.jar. 

P Download all listings in this issue as text 


project and deploy the outcome 
directly to Artifactory. In that case, 
we would not use mvn clean deploy 

because that is an antipattern. The 
better approach would be to fire an 
mvn clean install command and let 
Artifactory do the deployment in a 
transactional way. 

But, in our case, requirements 
might differ, for instance, needs 
for highly performant build cycles, 
and we've decided to take the built 
artifact from Stage land deploy it 
with Artifactory's generic integra¬ 
tion facility. For this, we can use an 
Ant-style configuration of the file 
pattern for the published artifacts 
(what to deploy) and target desti¬ 
nation (where to deploy). Our con¬ 
figuration might look like Listing 7. 

Now we're done with deploy¬ 
ing ongoing snapshot artifacts to 
Artifactory as part of our continu¬ 
ous build. Our Hudson build job 
history shows the Artifactory icon 
to document that binaries were 
deployed to Artifactory; see 
Figure 5, which shows that the 
Hudson build job history visualizes 
that artifacts were deployed 


to Artifactory. 

It comes in handy to be able to 
directly navigate from the build 
history to the built artifacts by just 
selecting the Artifactory icon of a 
specific build. We're then directed 
to Artifactory and can work on or 
just obtain information for those 
artifacts. Figure 6 shows the 
Artifactory browser listing different 
deployed snapshot versions. As 
you see, although we deploy snap¬ 
shot versions, inside Artifactory, 
artifacts are handled as unique, 
fully qualified versions. This is 
achieved by pure configuration 
inside Artifactory. 

In Artifactory, artifacts are 
browsable. You can operate on 
those artifacts depending on your 
permissions. 

We're done: Git commits con¬ 
tinuously trigger the pipeline, and 
new snapshot versions are pro¬ 
duced and distributed. That's fine 
for development, but we move 
on in the releasing process and 
sooner or later (with luck, sooner), 
we want to create a release, which 
we explore next. 
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Creating a Release 

Our releasing process is imple¬ 
mented in a dedicated Hudson 
build job. First, we want to check 
out a previously compiled and 
tested baseline of the continuous 
build. Thus, we parameterize the 
Hudson release build job with an 
input field of type String and assign 
HEAD to be its default value. During 
build job execution, it's highly 
recommended to enter a specific, 
well-tested Git commit hash, but 
for build chain testing purposes, 
HEAD might be sufficient. As the 
first build step, we can then access 
the parameter and check out the 
given Git commit as a shell execu¬ 
tion by using git checkout Srev. 

Hudson's Git plugin creates a 
clone, and performing the checkout 
aligns us with the desired baseline. 
Maven's Release plugin is often a 
good choice—see Section 5.4 in my 
Agile ALM book (Manning, 2011)— 
but sometimes it's not the best 
fit for the given requirements. An 
alternative is to directly apply fine¬ 
grained steps as needed. Examples 
include tagging in the VCS (for 
example, by executing shell com¬ 
mands as build steps) or setting the 
version number in the POM files. 
The latter can be achieved easily 
by a self-written Maven Mojo, as 
shown in Listing 8. 

The special trick with this Maven 
plugin is that it reads the project 


version of the Maven project it was 
applied on, strips its snapshot ver¬ 
sion, and dynamically assigns the 
result (that is, the release version) 
to the property newVersion. That 
property, in turn, is the input of the 
set goal of the Maven Versions plug¬ 
in. Thus, in the Hudson build job, 
we can fire the command shown in 
Listing 9 on the underlying to-be- 
released Maven-based project. 

We skip the generation of backup 
POMs, because we work on defined 
baselines and we can always roll 
back. Even better, we always roll 
forward because we just work on 
the new changes piped through 
the pipeline. Also, here, it does not 
make any difference whether we 
work on one POM or any hundreds 
of child modules. The procedure is 
the same. 

After we've patched the POM, the 
source code on the build machine 
is now ready to be tagged and 
deployed to a full-fledged compo¬ 
nent repository. We use mvn clean 
install to install the release artifact 
locally. Afterward, depending on 
our requirements, we orchestrate 
the target version number, that is, 
the version number the artifact 
is labeled with in the component 
repository. For that, we execute the 
shell as a build step in our Hudson 
release build job (see Listing 10). 

After processing, the release 
variable contains a string that is 
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LISTING 9 


LISTING 10 


package VersionFetcher; 

import org.apache.maven.plugin.AbstractMojo; 
import org.apache.maven. plugin. MojoExecution Exception; 
import org.apache.maven.project.MavenProject; 


y** 

* @goal release 

* @phase process-sources 

V 

public class VersionFetcher extends AbstractMojo { 
y** 

* (©parameter expression = "S{project}" 

* (©readonly 
*/ 

private MavenProject project- 

public void execute() throws MojoExecutionException { 
String version = project.getVersionQ; 

String release = version; 
if (version.indexOf("-SNAPSHOT") > -1) { 
release = version.substring^, version.indexOf( 
"-SNAPSHOT")); 

getLog().info("SNAPSHOT found:" + release); 

} 

project.getProperties().setProperty("newVersion", release); 

} 

} 

Download all listings in this issue as text 


enriched with a lot of useful con¬ 
text information including the 
version from the POM file, the first 
six characters of the Git hash, the 
Git revision number, and the build 


number of the executing Hudson 
build job. It's just an example, but 
you get the point: take the infor¬ 
mation that is most helpful to you; 
concrete requirements might influ- 
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ence your choice. But be aware of 
any implications. For example, only 
adding the build number from the 
Hudson build job itself is too frag¬ 
ile, because it is not unique across 
different Hudson build jobs. 

Let's now proceed with our 
releasing process. The local 
target directory contains the release 
artifact that was built by Maven. 

We want to assign our individual 
release version to it; thus, we copy 
the artifact, as shown in Listing 11. 

Now let's deploy the release arti¬ 
fact to our component repository. 
In our case, we use Bintray. Bintray 
is like a "GitHub for binaries." It's a 
social media service for developers 
to publish, download, store, pro¬ 
mote, and share open source soft¬ 
ware packages. We use Bintray's 


powerful REST API to distribute 
our artifact. 

First, for testing purposes only, 
we delete the target version of our 
component (in Bintray notation, 
this is a "package") in Bintray, as 
shown in Listing 12. This comes 
in handy if the version is available 
already and we don't need it. 

As you see, a cURL command is 
sufficient, but you can, of course, 
also wrap the handling with Groovy 
(see this library for encapsulating 
the access) or any other language 
of choice. 

Bintray follows some conven¬ 
tions. We host repositories (in 
our case, meow), which is owned 

by me, michaelhuettermann. An 
access key must be generated 
in Bintray, and we deposit it in 



§1 


michaelhuettermann meow cat 


Michael Hirlie. 
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cp devops/target/cat-Sversion.jar devops/target/cat-Srelease.jar 


Download all listings in this issue as text 


Hudson as a configuration vari¬ 
able. Our repository consists of a 
package named cat. 

Next we create the new target 
version by defining a Hudson build 
step to execute a shell script, as 
shown in Listing 13. After we've cre¬ 
ated the new version, we're ready 
to deploy the binary, as shown in 
Listing 14. 

Finally, we have to make the 
binary visible; that is, we have to 
publish it. We can do that either in 
Bintray's web application itself or 
we can again execute an API call 
(see Listing 15). 

As a result, we now have distrib¬ 
uted the artifact, in its new version, 
to Bintray. Figure 7 shows that the 
freshly published versions of arti¬ 
facts are available in Bintray. 

Crisp, isn't it? 

Conclusion 

This article explained some con¬ 
cepts for mastering binaries with 
Maven projects, and it introduced 
a powerful tool chain. We've done a 


round-trip through some concrete 
examples to show how part of a 
delivery pipeline can look. Now you 
are prepared to further streamline 
your software delivery process. As 
a result, you'll have more effective 
and efficient processes and tool 
chains and even more fun with your 
daily work. 

Now, I wish you much success 
with mastering your binaries 
and fun trying out these tools 
yourself! </article> 


MORE ON TOPIC: 


Development 
Tools and 
Techniques 


A LEARN MORE 

• DevOps for Developers, by Michael 
Huttermann (Apress, 2012) 

• Agile ALM, by Michael Huttermann 
(Manning, 2011) 
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Mary Had a Little Lambda 

Get familiar with lambdas and the Stream API through a simple game. 


L ambda expressions are 
the most impactful fea¬ 
ture to enter the Java lan¬ 
guage since the release of 
generics in Java SE 5. They 
fundamentally change the 
programming model, allow¬ 
ing a functional style of 
development, and they sup¬ 
port efficient parallelization 
of code to take advantage of 
multicore systems. However, 
as a Java developer, you will 
first notice the productiv¬ 
ity improvements you gain 
by using the new lambda- 
enabled APIs in Java SE 8. 

In this article, we will use a 
retro game written in JavaFX 
to walk through the new 
Stream API for working with 
collections and data. This 
game is a simple Java SE 8 
application written from the 
ground up to showcase lamb¬ 
das best practices, and it is 
also a visual guide to pro¬ 
gramming with the Stream 
API. However, we will first 
lay the foundation with an 


introduction to the lambdas 
language changes. 

Introduction to Lambdas 

To use lambdas, you must be 
using a recent Java SDK (ver¬ 
sion 8 or higher) and set the 
language level to Java SE 8 
when you compile. You can 
download the latest Java SDK 
version here. 

Developing lambdas is a 
lot easier when using an IDE 
that supports the new syntax. 
Most Java IDEs have been 
updated with lambdas sup¬ 
port and will assist you with 
real-time error reporting and 
code completion of lambdas. 
NetBeans IDE and IntelliJ are 
noteworthy as having the 
best lambdas support out of 
the box at the time of the Java 
SE 8 release, and both work 
well with the example we are 
demonstrating here. 

To demonstrate how the 
new lambdas feature works, 
here is a short snippet of code 
that iterates through a list of 


shapes and changes the blue 
ones to red: 

I for (Shapes: shapes) { 
if (s.getColorQ == BLUE) 
s.setColor(RED); 

} 

In Java SE 8, you could 
rewrite the same code by 
using a forEach and a lambda 
expression, as follows: 

I shapes.forEach(s -> { 
if (s.getColor() == BLUE) 
s.setColor(RED); 

}); 


The lambda form makes 
use of a new method on 
the Collection interface 
called forEach, which takes 
a lambda expression and 
evaluates it for all the con¬ 
tained elements. Similar API 
enhancements have been 
made throughout the Java 
core classes in order to sim¬ 
plify the usage of lambda 
expressions. 

A related question you 
might have is how the Java 
team was able to add in 
new methods to interfaces 
without breaking backward 
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compatibility. For example, if you 
have code that implements the 
Collection interface and does not 
have a forEach method defined, 
won't the upgrade to Java SE 8 
break your implementation? 
Fortunately, another feature called 
extension methods solves this prob¬ 
lem in Java SE 8. The implementa¬ 
tion of forEach on the Collection 
interface is shown in Listing 1 

Notice the new default keyword, 
which indicates that the method 
will be followed by a default imple¬ 
mentation. Subclasses are free to 
create their own implementation of 
the method, but if none is defined, 
the subclasses will get the standard 
behavior defined in the interface. 
This allows new methods to be 
added to existing interfaces in the 
core Java classes, as well as in your 
own libraries and projects. 

The actual lambda syntax is 
quite simple: in its full form, you 
supply the types and parameters 
on the left, insert a dash followed 
by the greater-than sign (->) in 


the middle, and follow that with a 
method body inside curly braces, 
as shown below: 

| (int a, int b) -> { return a + b; } 

In cases where the function 
returns a value, the code can be 
simplified by removing the curly 
braces, the return keyword, and the 
semicolon: 

(a, b) -> a + b 

Furthermore, in cases where 
there is only one parameter, you 
can leave off the parentheses: 

a -> a * a 

And finally, if you have no param¬ 
eters, you can simply leave the 
parentheses empty, as shown 
below, which is common for replac¬ 
ing Runnable implementations or 
other no-parameter methods. 

| () ->{ System.out.println("done");} 


METHOD REFERENCE 

LAMBDA EQUIVALENT 


1 Objects::toString 

obj -> Objects.toString(obj) 

STATIC METHOD REFERENCE 

1 Object::toString 

obj -> obj.toStringO 

MEMBER METHOD REFERENCE 

1 obj::toString 

() -> obj.toStringO 

OBJECT METHOD REFERENCE 

1 Object::new 

() -> newObject() 

CONSTRUCTOR METHOD REFERENCE 


Table 1 
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interface Collection<T> { 
default void forEach(Block<T> action) { 
Objects.requireNonNull(action); 
for (T t: this) 
action.apply(t); 

} 

// Rest of Collection methods... 

} 


P Download all listings in this issue as text 


In addition to the basic syntax, 
there is also a special shortcut syn¬ 
tax called method references, which 
lets you quickly create lambda 
expressions that refer to a single 
method as the implementation. 
The following table summarizes 
the different types of method ref¬ 
erences along with the equivalent 
long-form lambda syntax. 

The last concept that is impor¬ 
tant when working with the new 
lambdas methods is the creation of 
interfaces that allow you to accept 
lambda expressions. For this pur¬ 
pose, any interface that has one 
explicitly declared abstract method 
can be used to accept a lambda 
expression and is, thus, called a 
functional interface. 

As a convenience, a new 
Functionallnterface annotation was 
introduced that optionally can be 
used to mark interfaces in order to 
get assistance from the compiler in 


checking that the interface meets 
the requirement for a single, explic¬ 
itly declared abstract method: 

I @FunctionalInterface 
interface Sum { 
int add (int a, int b); 

Using this annotation is a recom¬ 
mended best practice, because it 
will catch corner cases in the defi¬ 
nition of functional interfaces— 
such as the inclusion of default 
methods that allow you to have 
multiple methods defined on a 
functional interface, because they 
are not abstract and don't count 
toward the single-abstract-method 
requirement. 

Now that you have a basic under¬ 
standing of the lambda syntax, it is 
time to explore the Stream API and 
see the power of lambdas in the 
context of a visual example. 
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Retro Gaming with Lambdas 

Mary had a little lambda 
Whose fleece was white as snow 
And everywhere that Mary went 
Lambda was sure to go! 

Nowadays video games are all 
about high-resolution 3-D graph¬ 
ics, cinematic-quality cut scenes, 



Figure 1 


and difficulty levels that range from 
newbie to pacifist. However, in the 
good old days of gaming, we just 
had sprites (see Figure!): cute, 
pixelated little figures dancing and 
walking their role-playing game 
(RPG)-way through well-designed 
and insanely difficult levels. 



Figure 2 



Figure 3 
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LISTING 2 LISTING 3 


ChangeListener<Object> updatelmage = 

(ov, o, o2) -> imageView.setViewport( 
new Rectangle2D(frame.get() * spriteWidth, 

direction.get().getOffset() * spriteHeight, 
spriteWidth, spriteHeight)); 
direction.addListener(updatelmage); 
frame.addListener(updatelmage); 

Q Download all listings in this issue as text 



Sprite-based graphics also hap¬ 
pen to be really simple to program, 
allowing us to build a full anima¬ 
tion system in under 400 lines of 
code. The full application code for 
our game is in GitHub. For all the 
graphics used in the game, the 
images are laid out in a standard 
3x4 tiled format, as shown in the 
sprite sheet for Mary (see Figure 2). 

The code for animating sprites is 
done (of course) using a lambda, 
and it simply moves the viewport 
around a tiled image in order to 
produce a three-frame walking ani¬ 
mation (horizontal) and to change 
the direction the character is facing 
(vertical). See Listing 2. 

Add a static image for a back¬ 
ground (see Figure 3), and some 
key event listeners to move the 
character upon input, and you have 
the basics of a classic RPG game. 

Generating Streams 

There are several ways to create 
a new java SE 8 stream. The easi¬ 


est way is to start with a collection 
of your choice and simply call the 

stream() or parallelStream() method 
to get back a Stream object, such as 
in the following code snippet: 

| anyCollection.stream(); 

You can also return a stream from 
a known set of objects by using 
the static helper methods on the 
Stream class. For example, to get 
back a stream that contains a set of 
Strings, you could use the code in 
Listing 3. 

Similarly, you can use the Stream 
numeric subclasses, such as 
IntStream, to get back a generated 
series of numbers: 

| IntStream.range(0, 50) 

But the most interesting way to 
generate a new series is to use the 

generate and iterate methods on 
the Stream class, which let you cre¬ 
ate a new stream of objects using 
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Figure 4 


a lambda that gets called to return 
a new object. The iterate method 
is of interest because it will pass 
in the previously created object to 
the lambda. This lets you return a 
distinct object for each call, such as 
returning all the colors in the rain¬ 
bow iteratively (see Listing 4). 

To demonstrate how this works 
visually, we are going to add a new 
barn element to the application, 
which generates a lamb when Mary 
steps on it. The code for the new 
Barn class is shown in Listing 5. This 
code specifies the image to use for 
the sprite-based graphic, which is 
passed in to the superconstructor, 
and implements a visit method that 
has the logic that will get executed 
when Mary steps on the barn. 


The first statement in the visit 
method simply gets the last ele¬ 
ment from the list of animals that 
are following Mary, or it returns 
her if there are no animals yet. This 
is then used as the seed to the 
iterate method, which gets passed 
to the Lamb constructor for the first 
invocation of the lambda. The lamb 
that gets generated by this is then 
passed in to the Lamb constructor 
for the second invocation, and this 
process repeats in succession. 

The resulting stream includes 
the seed (so we can use the skip 
function to remove that from the 
stream), and it is theoretically infi¬ 
nite. Because streams are lazy, we 
don't need to worry about objects 
getting created until we add a ter¬ 
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Stream.iterate(Color.RED, 
c -> Color.hsb(c.getHue() + .1, c.getSaturation(), 
c.getBrightnessQ)); 
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minal operation, but an easy way 
to fix the length of the stream is 
to use the limit function, which we 
will pass a parameter value of 7 to 
generate seven lambs that are fol¬ 
lowing Mary. 

The last step is to add a terminal 
operation that will use the stream. 
In this case, we will use a forEach 
function that applies a method 
reference to the add method on the 
list of animals. The result of execut¬ 
ing this lambda is the addition of 
sevens lambs following Mary in 
succession, as shown in Figure 4. 

The next element we are going to 
add to the game is a rainbow that 
will demonstrate filtering in the 
Stream API. The way the filter func¬ 


tion works is that it takes a predi¬ 
cate lambda, which evaluates to 
true or false for each element in the 
stream. The resulting stream con¬ 
tains all the elements for which the 
predicate lambda evaluated to true. 

For the logic of the rainbow, we 
will execute a filter that returns 
every fourth animal in the stream 
and apply a JavaFX ColorAdjust 
function to shift the hue to match 
the passed-in color. For white, we 
are using null (no color shift). The 
code in Listing 6 is the implemen¬ 
tation of the visit method for the 
rainbow MapObject. 

When Mary steps on the rain¬ 
bow, all the lambs get colored 
according to the Color values you 
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Figure 5 



Figure 6 


specified (see Figure 5). 
"Lamb"da question 1. What hap¬ 
pens if you step on the barn after 
visiting the rainbow? 


Another way to use filtering is to 
take advantage of the new meth¬ 
ods added to the Collection API 
that accept a predicate lambda. 
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Predicate<SpriteView> pure = 
a -> a.getColor() == null; 

mealsServed.set(mealsServed.get() + 
s.getAnimals().filtered(pure).size() 

); 


s.getAnimals().removeIf(pure); 

Q Download all listings in this issue as text 


These include removelf, which fil¬ 
ters out all the elements that don't 
match the given predicate, and 
filtered, which is on ObservableList 

and returns a FilteredList contain¬ 
ing only the items that match 
the predicate. 

We will use these methods to 
implement a Church object that 
will filter on "pure" (white) animals; 
then, any animals that are white 
will be cooked by the church staff to 
feed the needy. This functionality 
includes incrementing the coun¬ 
ter of "meals served" and remov¬ 
ing the "pure" animals from the 
list. The code for the church visit 
method is shown in Listing 7 

You can see the result of succes¬ 
sively stepping on the rainbow and 
the church in Figure 6. 

"Lamb"da question 2. Is it possible 
to use the church to remove all the 
animals after they have already 
been colored? 

The map function is probably the 


most powerful operation in the 
Stream API. It allows you to convert 
all the elements in the stream from 
one type of object to another, per¬ 
forming powerful transformations 
along the way. We will use this to 
implement a chicken coop where all 
the animals following Mary will get 
converted into eggs. 

I have two implementations of 
the visit method for the chicken 
coop. The first one uses a single 
map operation with a lambda 
expression to replace the stream 
elements with eggs, as shown in 
Listing 8. 

The second implementation 
uses method references with a 
chained set of map operations to 
first convert the stream to a stream 
containing who the animals are fol¬ 
lowing, and then to call a construc¬ 
tor method reference to create the 
eggs, passing in the information 
shown in Listing 9 to the construc¬ 
tor parameter. 
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Figure 7 
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Figure 8 


The code in both of these listings 
behaves and performs similarly, 
because the Stream API is designed 
to be lazy and only evaluate the 


stream when a terminal operation 
(such as collect) is called. Therefore, 
it is primarily a style issue as to 
which version you prefer to use. 
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// ora double map: 
s.getAnimals().setAII(s.getAnimals() 
.stream().parallel() 
.map(SpriteView::getFollowing) 
.map(Eggs::new) 
.collect(Collectors.toList()) 

); 


Q Download all listings in this issue as text 


Running the program with the new 
chicken coop MapObject will let 
you generate eggs from lambs, as 
shown in Figure 7. 

"Lamb"da question 3. If you send 
colored lambs to the chicken coop, 
what color are the eggs? 

Notice that each of the egg sprites 
contains three little bouncing eggs. 
Wouldn't it be nice if we could hatch 
these guys into chickens? 

To hatch the eggs, we will add in 
a new MapObject for a nest where 
the eggs will be hatched into a 
group of three chickens using the 
hatch method shown in Listing 10. 

Notice that the hatch method 
returns a stream of objects, which 
means if we used a normal map 
operation we would get back a 
stream of streams. To flatten the 
stream into a single list of chick¬ 
ens, we can instead use flatMap, 
which will map the stream using a 
lambda function and also collapse 
the nested streams into a single 


list of objects. The implementation 
of the nest visit function utilizing 
flatMap is shown in Listing 11 

Now, upon bringing eggs to the 
nest, you will get an explosion of 
chickens, as shown in Figure 8. 
"Lamb"da question 4. About how 
many animals can you add before 
the game runs out of memory? 

The final element we will add is a 
fox to demonstrate how to reduce 
a stream. For this, we will first 
map the stream to a list of inte¬ 
gers according to the weight of the 
animals, and then we will reduce 
that to a single value using a sum 
method reference. See Listing 12. 
The reduce function takes a seed 
value (for which we will use 0) 
and a function that can reduce 
two elements into a single result. 
This lambda will be applied recur¬ 
sively for all the elements in the 
stream until a single value results, 
which will be the sum of all the 
animals' weights. 











































































































//rich client / 



Figure 9 


We then take the sum (stored 
into the variable called mealSize) 
and use that to stretch the fox 
proportionally. Figure 9 shows the 
result of a tasty meal for the fox. 
"Lamb"da question 5. How can you 
change the code for the fox to make 
him fatter when he eats? 

Conclusion 

In this article, we covered the basic 
lambda syntax, including method 
references, extension methods, 
and functional interfaces. Then we 
went into detail about the Stream 
API, showcasing some of the com¬ 
mon operations, such as iterate, 
filter, map, flatMap, and reduce. 

As you have seen, Java SE 8 
lambdas dramatically shift the 
programming model—allowing you 


to write simpler and more-elegant 
code, and opening up the possibil¬ 
ity of new powerful APIs such as 
Stream. Lambdas are also used 
extensively throughout the Java 
core APIs, including new functions 
on I/O, inclusion in the new Date 
and Time API, and functional inter¬ 
faces added to APIs with callbacks 
like JavaFX. This all leads to a more 
functional style of programming 
that you can use to build code that 
runs efficiently on multiproces¬ 
sor systems. Why not start taking 
advantage of these capabilities in 
your own code? </articie> 

A LEARN MORE 

• Stream API 

• Example game on GitHub 
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Leap Motion and JavaFX 

Use 3-D hand movements to interact with JavaFX applications. 


S ooner or later, there might 
come a day when par¬ 
ents have to explain to their 
children what a keyboard 
is. Children will have a hard 
time understanding why their 
parents used such a strange 
device for many decades. 
Although today is not yet that 
day, we are already seeing 
devices that provide more- 
intuitive, natural input than 
a keyboard, a mouse, or a 
trackpad do. These devices do 
not necessarily replace exist¬ 
ing input devices, but they 


can be very complementary. 

It is important that the 
software we write and use 
today not be restricted to a 
limited set of input devices. 
The JavaFX platform can eas¬ 
ily be integrated with new 
input devices. This article 
shows how the Leap Motion 
Controller device can be used 
as a user input device in 
JavaFX applications. 

The Leap Motion Controller, 
a small device produced by 
the Leap Motion company, is 
equipped with infrared cam¬ 


eras and infrared LEDs. This 
device is capable of track¬ 
ing hand and finger move¬ 
ments around the device in 
a clipped pyramid that has a 
radius of about 1 meter. The 
device is connected to a com¬ 
puter using a USB cable. Leap 
Motion provides native driv¬ 
ers for Windows, Linux, and 
Mac systems. On top of those 
drivers, a number of APIs for 
different programming lan¬ 
guages are available. These 
APIs allow developers to cre¬ 
ate applications that leverage 
the Leap Motion Controller. 

Fortunately, a Java API is 
available. We will now explore 
how you can use the Java API 
in a Java client application to 
interact with the Leap Motion 
Controller, but first we will 
briefly discuss the capabilities 
of the Leap Motion Controller. 

Fora thorough under¬ 
standing of the Leap Motion 
Controller, see the Leap 
Motion website and the Leap 
Motion developer website. 


Also visit the developer 
website to download the 
Leap Motion Software 
Development Kit (SDK), 
which allows you to create 
applications. 

Using the Leap Motion SDK 

Leap Motion provides an 
SDK for Windows, Mac OS, 
and Linux. The SDK contains 
a number of files, some of 
which are required for Java 
development, for example: 

■ AJava library named 
Leapjava.jar, which provides 
the API we can use in Java 
applications 

■ Operating system- 
dependent native libraries 
that connect to the Leap 
Motion Service, which 
receives data from the Leap 
Motion Controller device 
over USB 

To run Java applications 
that communicate with the 
Leap Motion Controller, the 
native libraries need to be in 
the native library path. This is 
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achieved by starting the 
Java applications with 
the system property java 
.library.path pointing to 
the location of the native 
libraries foryour particu¬ 
lar OS, for example, java 
-Djava.library.path=/path/ 
to/LeapSDK/lib/x64 on a 
64-bit system. 

The Java library 
Leapjava.jar file should be 
in the classpath. 

Leap Motion Controller 
Concepts 

Because the Leap Motion Controller 
is capable of tracking hands and 
fingers in three directions, the 
retrieved data is obtained in a 
three-dimensional right-handed 
Cartesian coordinate system. The 
origin of this coordinate system is 
located at the center of the top of 
the device. The x, y, and z axes are 
pointing in the directions shown in 
Figure 1. 

All data obtained from the Leap 
Motion Controller is contained in 
instances of the com.leapmotion 
.leap.Frame class, which is part of 
the Leapjava.jar library. Depending 
on environment variables, the 
device sends frame data with a fre¬ 
quency between 30 Hz and 200 Hz. 

There are two ways of obtain¬ 
ing the frame data, both of which 
require an instance of the com 


.leapmotion.leap.Controller class 
to operate: 

■ By polling the Controller 

■ By registering a Listener with the 
Controller, which will be notified 
when new data is available 
When using JavaFX, the second 

approach is the most intuitive. The 
callback function on the Listener 
can be used to change properties 
in the data model of the applica¬ 
tion, and the JavaFX pulse thread 
will make sure the changes are 
reflected in the user interface. 
Because a pulse event is generated 
at most 60 times a second, the UI 
thread won't be overloaded when 
the Leap Motion Controller pro¬ 
vides more data than the graphical 
system can handle. 

The code in Listing 1 shows how 
to create a Controller and register 
a Listener in a JavaFX application. 
The LeapListener class we introduce 
here extends the com.leapmotion 



Figure 1 
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LISTING 1 LISTING 2 


public class LeapConcepts extends Application { 
Controller c; 

Listener I; 

public void start (Stage stage) { 

.... // set up the scene and stage 
c = new Controlled); 

I = new LeapListener(this); 
c.addListener (I); 

} 

} 


Download all listings in this issue as text 


.leap.Listener class, as shown in 

Listing 2. 

This Listener class will be called 
upon lifecycle events and when¬ 
ever a frame containing tracked 
data is available. The onConnect 
method is called whenever the 
controller instance connects to a 
Leap Motion device. When, for 
some reason, the connection is 
broken, the onDisconnect method 
is called. Obviously, the onFrame 
method is called whenever a new 
frame with data is available. 

Available Data 

As mentioned before, all infor¬ 
mation we receive from the Leap 
Motion Controller is available on 
instances of the Frame class. This 
article gives a brief, nonexhaustive 
overview of the data that is avail¬ 


able. The Java documentation on 
the Leap Motion website contains 
all the information for this class and 
the other classes. 

The Leap Motion Controller is 
capable of tracking the position, 
direction, and movement of hands, 
fingers, and tools (for example, a 
pencil). Based on internal calcula¬ 
tions, this allows the Leap Motion 
Service to also track a number of 
gestures, for example, swiping, tap¬ 
ping, and making a circular move. 

If we want information on the 
tracked hands in a frame, we call 
frame.handsQ.This method returns 
a HandList, which is an Iterable that 
can be used to obtain a number 
of tracked Hand instances. A Hand 
instance has a number of proper¬ 
ties: for example, the location, the 
normal vector, and the velocity of 
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the hand's palm or the fingers that 
are detected on the hand. 

Fingers can be tracked individu¬ 
ally as well by calling frame.fingersQ. 
This method returns a FingerList 
that can be used to obtain informa¬ 
tion about the detected fingers (for 
example, direction, location, and 
velocity). 

Consequently, gestures are 
obtained by calling frame.gestures(), 
which returns a GestureList. Note 
that gestures will be added to the 
frame data only if the Controller 
is instructed to do so. Flence, it is 
good practice to enable gesture 
tracking in the onConnect method 
of the class extending the Listener 
class, as shown in Listing 3. 

The code in Listing 3 will make 
sure that when swipe or key-tap 
gestures are performed by the user, 


the corresponding information is 
added to the Frame instances that 
are provided. 

Threading 

Both theJavaFX platform and 
the Leap Motion Controller soft¬ 
ware have some specific require¬ 
ments regarding threading. 
Fortunately, these requirements 
match very well. 

When writing JavaFX applica¬ 
tions, it is good practice to separate 
the view and the data. That is, user 
interface components are defined 
and glued together, but the data 
that describes their behavior (for 
example, the position of a circle or 
the width of a text field) is kept in 
JavaFX properties. These properties 
are altered whenever needed, but 
this does not mean that the user 



Figure 2 
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LISTING 3 


(©Override 

public void onConnect (Controller c) { 
c.enableGesture(Gesture.TYPE.TYPE_SWIPE); 
c.enableGesture(Gesture.TYPE.TYPE KEY TAP); 

} 
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interface is redrawn every time a 
property changes. 

It is a requirement, though, that 
changes to properties that can 
lead to changes in the user inter¬ 
face be executed on the JavaFX 
application thread. 

The Leap Motion native library 
will create a new Java thread 
whenever a new Frame instance is 
available, and it will call Listener 
.onFrameO —if a Listener is regis¬ 
tered with the Controller, that is. 

The rate by which new threads 
are created is between 30 and 200 
times a second. However, it turns 
out that a new thread is created 
only when the previous thread 
completed its work, that is, when 
the Listener.onFrameO method 
returns. This prevents a thread¬ 
flooding situation, where threads 
are created at a higher pace than 
they can be processed. 

The combination of these two 
systems leads to an approach 
where the onFrameO method on 
the Listener is used to (directly 


or indirectly) change the properties 
of UI components, which are 
subsequently rendered. The 
schema shown in Figure 2 
describes the flow. 

In this flow, the implementation 
of the Leap Motion Listener is using 
the Platform.runLater() approach 
to change properties of the JavaFX 
controls. This guarantees that 
those properties are modified only 
by the JavaFX application thread, as 
required by theJavaFX platform. 

In practice, and especially in 
more-complex applications, it is 
often useful to add a step between 
the Listener implementation and 
the JavaFX controls. By doing so, 
the separation between the Leap 
Motion interface and your JavaFX 
application is even clearer. 

For brevity, in this article, we will 
use the approach where the imple¬ 
mentation of the Listener modifies 
the properties of the JavaFX con¬ 
trols directly, using the Platform 
.runLater() approach. 

We will demonstrate the flow 
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with a very simple example: we will 
write a JavaFX application that dis¬ 
plays a circle. The location and the 
radius of the circle are determined 
by hand movements. The full code 
for this example is available at this 
Bitbucket site. 

As stated at the beginning of 
this article, JavaFX allows you to 
create client applications in which 
there is a large degree of indepen¬ 
dence between the layout and the 
input devices. We will first create 
a JavaFX application that is not 
dependent on the presence of the 
Leap Motion Controller. The code in 
Listing 4 generates a layout with a 
circle positioned in the middle. 

As you can see from this code, 
the location (via the translateX 
and translateY properties) and the 
radius (via the radius property) are 
bound to JavaFX proper¬ 
ties. These properties are 
declared in ourJavaFX 
application, and they are 
made available via public 
methods, as shown in 
Listing 5 

So far, this application 
is very static. It shows a 
green circle with a fixed 
radius at a fixed posi¬ 
tion. We will now write a 
class that listens for Leap 
Motion Controller data. 

We do this by extending 
the Leap Motion Listener 


class, as shown in Listing 6. 

In this class, we override the 
onFrameQ method. Ourimple- 
mentation of this method will 
be called when new frame data 
is available. The frame data is 
obtained by calling Frame frame = 
controller.frameQ;, where the 
controller instance is passed via 
the method invocation. 

As shown in Listing 6, we can 
obtain the detected hands easily 
by calling HandList hands = frame 
.hands();. If no hands are detected, 
the hands.isEmptyQ call will return 
true, and we do nothing. If at least 
one hand is detected, we obtain it 
by calling Hand hand = hands 
.get(O);. The position of the palm of 
the detected hand is obtained as a 
three-dimensional vector by calling 
hand.palmPosition(). 

We map thexand the 
z coordinates of the Leap 
Motion coordinate sys¬ 
tem with the translateX 
and translateY properties 
of the circle we created 
in the JavaFX applica¬ 
tion. They coordinate 
is mapped to the radius 
property. 

Note: Working with 
the Leap Motion APIs 
involves some math¬ 
ematics. You have to 
transform the coordi¬ 
nates obtained from 
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JavaFX allows 
you to create 
client applications 
in which there is a 

large degree of 
independence 

between the 
layout and the 
input devices. 
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LISTING 5 / LISTING 6 / LISTING 7 


public class LeapConcepts extends Application { 
(©Override 

public void start (Stage primaryStage) { 

Circle circle = newCircle(20); 

circle.setFill(Color.GREEN); 

circle.translateXProperty().bind(centerX); 

circle.translateYProperty().bind(centerY); 

circle.radiusProperty().bind(radius); 

StackPane root = new StackPaneQ; 

root.getChildren().add(circle); 

Scene scene = new Scene(root, 300, 250); 

primaryStage.setScene(scene); 

primaryStage.showO; 

} 

}’ 
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the Leap Motion Controller to 
pixels on the screen. The Leap 
Motion Controller coordinates are 
expressed in millimeters distance 
from the center of the top of the 
Leap Motion. 

Because the onFrame method is 
called on a thread created by the 
native Leap Motion libraries, we 
cannot change JavaFX properties 
directly. Instead, we have to use the 
Platform.runLater() pattern in order 
to push the changes to the JavaFX 
properties onto the event queue. 

The only remaining thing we have 
to do is to create an instance of our 


Listener and add it to a Controller. 

This is done in our application class, 
as shown in Listing 7. 

The Controller is created on the 
JavaFX application thread, as is 
the Listener. These methods return 
immediately, though, and they 
do not freeze the user interface. 

It is important to maintain a ref¬ 
erence to the controller object, 
in order to prevent it from being 
garbage collected. 

Simple Map Application 

The example we have explored 
so far is very basic, but it outlines 
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Figure 3 


the core principles you have to 
use when integrating Leap Motion 
Controller data into yourJavaFX 
application. 

The possibilities are endless. We 
will close this article with a simple 
map application that is navigated 
using the Leap Motion Controller 
rather than with a mouse. The code 
for this map application is available 
here. Figure 3 shows a screenshot 
of this application. 

We apply the same core prin¬ 
ciple as in the previous example, 
which means that we first create a 
map application that does not have 


dependencies on the input device. 

We create a MapArea instance 
that serves as the container where 
we put MapTile instances. A MapTile 
represents a 256-x-256-pixel piece 
of the world map at a given zoom 
level. We obtain these tiles from 
OpenStreetMap, which is an open 
data effort built by a community of 
mappers. The calculations required 
to map coordinates and zoom lev¬ 
els onto pixels is beyond the scope 
of this article. The MapArea class 
contains a loadTiles() method that 
will load new MapTile instances and 
their corresponding map images 
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(©Override 

public void onFrame(Controller controller) { 

Frame frame = controller.frame(); 

HandList handList = frame.handsQ; 

Iterator<Hand> handlterator = handList.iterator(); 
while (handlterator.hasNextO) { 

Hand hand = handlterator.nextQ; 
if (hand.isValid() && (hand.fingers().count() > 2)) { 
Vector palmPosition = hand.palmPosition(); 
final float x = pa Imposition. getX(); 
final float z = palmPosition.getZO; 
final floaty = pa I m Position.getY(); 

Platform.runLater(() -> { 
if (Math.abs(x) > 10) { 
area.moveX(x/10); 

} 

if (Math.abs(z) > 10) { 
area.moveY(z/10); 

} 

if (Math.abs(y-150) > 20) { 
area.moveZoom(y-150); 

} 

}); 

} 

} 

} 
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when needed. There are two 
potential causes for this: 

■ The user is panning the map, and 
a new area is shown 

■ The user is changing the zoom 
level, and a more detailed ver¬ 
sion of the map tiles should be 
rendered 


All of this can be achieved via a 
traditional mouse or trackpad, but 
we can easily add a Leap Motion 
Listener that achieves the same 
end. We extend the Leap Motion 
Listener class and implement the 
onFrame method as shown in 
Listing 8. 
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In this code, we once 
again detect the posi¬ 
tion of the hand. This 
time, however, we add 
an additional check: 
we will move or zoom 
only if the user opens 
his hand. We do this 
by asking how many 
fingers are detected. 

When a hand is closed, 
the Leap Motion 
Controller won't count 
fingers on it. As long 
as we count at least 
two fingers, we decide 
the hand has been 
opened. 

Next, we will move 
the map area propor¬ 
tional to the location 
of the hand, and the 
zoom level will be 
changed proportional 
to the height of the hand. 

Conclusion 

As we showed in this article, only a 
little bit of code is required to inte¬ 
grate the Leap Motion Controller 
into existing applications. There are 
huge challenges and, hence, huge 
opportunities for determining the 
best way to react to hand move¬ 
ments. Intuition is very important 
in this area. Creative developers will 
probably have fun experimenting 
with this cool device. 


The JavaFX platform 
provides a great envi¬ 
ronment for combining 
new input devices and 
existing or new Java 
code. 

Special care is 
required when deal¬ 
ing with threading, 
but the JavaFX thread¬ 
ing model allows for 
a perfect decoupling 
between the render¬ 
ing of the user inter¬ 
face, and dealing with 
background events and 
computations. 

Using JavaFX, devel¬ 
opers can leverage the 
great graphical poten¬ 
tial provided by the 
JavaFX controls. The 
whole Java platform is 
available for enriching 
the applications—for example, by 
providing communication to back¬ 
end systems. </article> 


r LEARN MORE 

• Leap Motion website 

• Leap Motion developer website 

• NightHacking video: Interview 

with Johan Vos on JavaFX and 

Leap Motion 


USE YOUR INTUITION 


Only a little bit of 
code is required to 
integrate the Leap 
Motion Controller 
into existing 
applications. There 
are huge challenges 
and, hence, huge 
opportunities for 
determining the best 
way to react to hand 
movements. Intuition 
is very important in 
this area. 
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1y\ 4 He NW c k/Apnl 20lH 'iss^e, 

RomAiViAn po[yj\o-{ develops A44'|U BaIazs ^Ave 
ias a conCiA*'*'£nCy ci^Allenge. He showed <as code 
4b<*4 soi*\e4'imes ^ys4e^*io<ASly "drops'* Aciremen4A4'to»<\ 
A44emp4s And <xsked <as To*- a F*- Tbe. covirec4 Answer 
is #3. Tbe problem is 4b*4 a «^<xce condHtOn e*is4s beTween 4be 
mdH’id'AAl caUs 4° cn4s. For eXAAAple, we cAn u,av£ a scenario 
WLytrt 4b r eAd 1 «^e^ds 4be ^Alne -for cownTe*' X And 4be*\ Tb^eAd 2 
re^ds 4be sAn\e '/^ke. Bo4b cAlcvdATe 4be incvememfed v-xUe And 
bo4b w*d4e i4 bACk., res<Al4m5 m a +1 ’mCvemenT ^^4bfc^ 4b^*\ a 
+ 2 ‘mCiremewf as expec4ed- Tbe^e \s a s'tm'ilAr- vACe condHtOn w',4b 
^egAvd 4 o •.nUW.zmg 4be co<nn4e^s. 

Al4b 0( Agb Al wowld wovk., i4 wowld de4-e<x4 4be pv^pose o-f vvs'mg 
^ ConCinmrenTHAsbNHp- #2 woinldHT w/ork. beCAwse ’i4 b^s 4be 

sAn\e problems (’mdmid'AAl ope*'^4ions Are a4oaa'iC *'<a4u v £*' 4b^*v 4be 
compile se^ence oT eve*\4s). 4f L 4 cAn be mAde 4° work., bivf i4 
woiAld retire exT^A bookkeeping. 

This issue’s c^Allenge con\es T-rom Simon R' t 44er, Sava e^Angel'ts4 

a 4 Oracle, wi^o presets ias w'Hb a sT^eAms problem. 

1 THE PROBLEM 

G-Wen code 4b*4 es 4be new Sava SE £ S4^£Am APX 4° 
de4e^m'me 4be leng4b °X 4be longes4 line in a 4e*4 File, bow CAn we 
con^e*'4 4biS 4° ^e4v\rn 4be Ac4v\Al I'me, rA4b£* r Tb^n <4s leng4b? 



2 THE CODE 

Tbe I'mesO me4b°d ©4- 4be BvvITVedReAde* - cIass is new ’m Sava SE £ And 
^e4vvrns a s4* r eArA o-f S4Hngs 4b^4 Are 4be 4e*4 lines °I 4be Fie- Tb’ts is pAssed 
4® 4be mApToXn4() ^&4b°c!, gene^A4es An In4S4^eAn\ ws’mg 4be me4b°d 
^epe^ence 4o S4»'*i^\^-leng4b() ^ Xwnc4iOn. Tbe 4e^m'mAl operA4iOn mAx() 

ideA’iFes 4be lAr^es4 ^AliAe m 4be s4* , eAm And re4'A*'ns An Op4t°nAlXn4 objec4- 
Tbe ge40 me4b°c! »^e4'A*'ns 4be vAliAe °T 4be Op4t°nAlXn4 4b A 4 is AiA4o">Anboxed 
4o An m4 And Assigned 4° 4be vAr'tAble, longes4- 

BufferedReader reader = new BufferedReader(new FileReader 
("foo.txt")); 

int longest = reader.lines().mapToInt(String::length) 

.max().get(); 



How cowld we ci^An^e 4bis code 4° ^e4wn 4be longes4 line m 4be File? 

3 WHATS the fix? 

I') String longestLine = reader . lines () .max (String :: longest] 
.orElse ( ""); 

2) String longestLine = reader.lines().reduce( (a, b) 

-> a.length() > b.length () ? a : b) .orElse (""); 

3) String longestLine = reader.lines().reduce("", (a, b) 

-> a.length() > b.length ()); 

*"0 String longestLine = reader. lines () .max ( {a, b) 

-> b.length() - a.length ()).orElse(""); 

5^ String longestLine = reader.lines().sorted( {a, b) 

-> a. length () - b . length ()). findFirst () 

.orElse ( ""); 
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THE ANSWER? 

Loor -fW 4He Answer A 4He *\e*4 iss^e. CV s^b^'H yow ou/v\ co<4e ci^AUe^e! 
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